Developer Documentation - منصة استقل للإعلانات وخدمات السيو

External Share API

The External Share API allows you to integrate a "Share on MYADS" button on your website. When users click this button, they will be redirected to MYADS with a post composer pre-filled with your content.

API Endpoint

https://ads.estaql.com/share

Parameters

Name :	Type	Description
`text`	String	The text content to be pre-filled in the post composer. Can include links, hashtags, and mentions.

Usage Examples

HTML Link

The simplest way to integrate sharing is a standard anchor tag.

                <a href="https://ads.estaql.com/share?text=Check out this site! https://ads.estaql.com" target="_blank">
    Share on MYADS
</a>
            

JavaScript Button

You can also use JavaScript to dynamically generate the share URL.

                function shareOnMyAds(text) {
    const baseUrl = "https://ads.estaql.com/share";
    const shareUrl = `${baseUrl}?text=${encodeURIComponent(text)}`;
    window.open(shareUrl, '_blank');
}

// Usage
shareOnMyAds("I love using MYADS! #Social #AdExchange");
            

Best Practices

Use Hashtags: Include hashtags to make your content discoverable in the community feed.
Include Links: The system will automatically generate a link preview if a valid URL is included.
URL Encoding: Always URL-encode the text parameter to ensure special characters and spaces are handled correctly.