Publishers API
- 1 1. Get started
- 2 2.1. Search for the Offers (include tracking links)
- 3 2.2. Get Offer details
- 4 2.3. Get Offers list
- 5 2.4. Get conversions report
- 6 2.5. Search offers by domain
- 7 2.6. Apply to the Offer
- 8 3.1. Get coupons
- 9 4.1. Get publisher's sources types
- 10 4.2 Get a list of the publisher's sources
- 11 4.3 Get or create a tracking link
- 12 4.4 Generate AliExpress RU Deeplink (comming soon)
- 13 5 Feeds
- 14 5.1 Fetch possible offer list to generate feeds.
- 15 5.2 Generate feed
Updated:
1. Get started
API token can be retrieved on the “Account->Api Settings” page.
You can add token in two ways:
– through GET parameter ?token=yourtoken
– through Authorization Header Bearer {yourtoken}
2) Routes
The main route of all requests:
2.1. Search for the Offers (include tracking links)
Desc: This API method provides the ability to filter offers by type, category, status, geo, and keyword. Also, it allows getting tracking links included in the response if source_id would be provided. Please take note that the response doesn't contain data about offer visibility and application status to the offers with "need approval" visibility, "2.3. Get Offers list" should be used in case information about the offer visibility and application status is required.
API Users should also take note of the errors returned by the API in the data.*.tracking_link response field.
Route: /getOffers
Type: GET
Update 30/03/2023: fixed a bug with the returned list of campaigns if there was no filtering by status. Previously all campaigns were returned by default, but now the API method will return only active ones.
Name | Values | Description | Example | Required |
type | cps, cpa, cpi | type=cps | No | |
category | filter by category name | category=nameOfCategory | No | |
status | inactive, all, active | Offer status. The default value is active | No | |
search | Search by offer title, offer description and offer URL. | No | ||
geo | geo of ISO 3166-1 alpha-2 format https://gist.github.com/vxnick/380904 Set GEOs by comma | geo=AI,AF | No | |
limit | int, min:1, max:100, default:25 | Limit set number of offers in response | limit=25 | No |
page | int | Page in the total amount of response results | page=5 | No |
overage | true,false | filter by overage CAP | overage=true | No |
source_id | int | source_id could be taken from the list of sources in the platform or using "4.2 Get a list of the publisher's sources" API method. It is required to get tracking links in response | source_id=1232 | No |
google_ads_compatible_only | true,false | Filter the offers to return only those that are compatible with Google Ads | google_ads_compatible_only=1 | No |
Response fields:
Name |
| Values | Description |
status |
| success, error | Request status |
message |
| Success or error message | |
count |
| Number of results in response (in data array) | |
totalCount |
| Number of total results | |
totalPages |
| Number of available pages (according to used limit value) | |
page |
| Current page number | |
data |
| List of offers | |
data.*.id |
| Offer id | |
data.*.website_url |
| Offer website preview link | |
data.*.status |
| Offer status | |
data.*.category |
| Offer category |