Programs (v1.0)
1. Quick start
Make an authenticated GET request to the endpoint below. The response is a JSON list of programs matching your filters.
Endpoint
GET https://api.advanced-store.com/publishers/programs/1.0/
Required headers
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json
Minimal example
curl --location 'https://api.advanced-store.com/publishers/programs/1.0/?siteId=100&page=1&size=10' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json'
2. Authorization
Every request requires a Bearer token. If you don't have one yet, follow the guide here: advanced API – Get an access token.
Pass the token in the Authorization header on every call:
Authorization: Bearer ory_at_...
3. Request parameters
Parameters are appended to the URL as standard query-string parameters. They are grouped below by purpose for easier scanning.
3.1 Required
Name | Type | Description |
| integer | Your siteId. |
| integer | Page number for pagination. |
| integer | Number of results returned per page. |
3.2 Filtering
Name | Type | Description |
| string | Filter results by search string, e.g. an advertiser name. |
| string | Filter results by category. |
| 2-letter code | Filter results by country, e.g. countries=(DE,AT) |
| string | Filter results by domain, e.g. |
| integer | Filter results by the SubID length supported by the program. |
| boolean | if set to true returns only programs that have a favicon available |
| integer list | Filter by commission type. |
3.3 Sorting
Name | Type | Description |
| string | Sort by |
| string |
|
3.4 Output options
Name | Type | Description |
| string | Internal identifier you can attach to track different campaigns or placements. |
|
| When set to |
4. Full example request
curl --location 'https://api.advanced-store.com/publishers/programs/1.0/?page=1&size=1&siteId=100&maxSubIdLength=256&countries=DE&categories=Fashion&logos=1&subId=bla&sortBy=name&sortOrder=DESC' \
--header 'Authorization: Bearer ory_at_ImP4...' \
--header 'Content-Type: application/json'
5. Response
The response is a JSON object containing pagination metadata and an array of program objects.
5.1 Example response
{
"totalEntries": 1,
"currentPage": 1,
"totalPageCount": 1,
"pageSize": 10,
"programDataList": [
{
"id": 455,
"externalNetworkId": "23875",
"name": "Saninforma",
"lastUpdated": 1704183773144,
"url": "saninforma.it",
"matchingUrls": [],
"categories": [
"Health & Care"
],
"countries": [
{
"countryCode": "IT",
"name": "Italy"
}
],
"averageCommission": 2.36,
"clickLink": "https://as.ad4m.at/ad/tur? a=1267&b=Test&c=https://saninforma.it",
"activeAds": {
"Text": 1,
"advanced API": 1,
"Display": 11
},
"maxSubIdLength": 200,
"acpm": 0.46
}
]
}5.2 Top-level fields
Field | Description |
| Total number of programs matching your filters. |
| The page number returned (echoes your |
| Total number of pages available with the current |
| Number of items per page. |
| Array of program objects (see below). |
5.3 Program object fields
Field | Description |
| Internal advanced store identifier for the program. |
| The program's identifier on its source network. |
| Advertiser / program name. |
| Timestamp of the last update (ms since epoch). |
| The main domain of the program. |
| More specific URLs for the program. Used mainly to distinguish between programs of the same advertiser, e.g. different countries or business areas. |
| Categories the program belongs to. |
| Countries where the program can be advertised. Each entry contains a |
| Average commission in EUR across all past transactions for this program. |
| Percentage of sales confirmed in the past. |
| The tracking link for this program – use this URL to earn commission. See note below. |
| Which ad types are available for this program in our database (e.g. Text, Display, advanced API). |
| Maximum number of characters this program's network supports for SubIDs. Longer SubIDs will be truncated. |
| Average CPM value for the program. |
Tip: clickLink is generated through our Redirect API. If you don't need the enriched information from the program response, you can build tracking links directly without calling this endpoint.
6. Common use cases
Below are a few ready-to-copy examples. Replace YOUR_ACCESS_TOKEN and siteId=100 with your own values.
Get all German fashion programs
bash
curl --location 'https://api.advanced-store.com/publishers/programs/1.0/?siteId=100&page=1&size=50&countries=DE&categories=Fashion' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json'
Get the most recently updated programs first
bash
curl --location 'https://api.advanced-store.com/publishers/programs/1.0/?siteId=100&page=1&size=20&sortBy=lastUpdated&sortOrder=DESC' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json'
Get only CPA and CPL programs, including logos
bash
curl --location 'https://api.advanced-store.com/publishers/programs/1.0/?siteId=100&page=1&size=50&commissionTypes=(2,3)&logos=1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json'
Search programs by advertiser name
bash
curl --location 'https://api.advanced-store.com/publishers/programs/1.0/?siteId=100&page=1&size=10&search=zalando' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json'
Attach a SubID for campaign tracking
bash
curl --location 'https://api.advanced-store.com/publishers/programs/1.0/?siteId=100&page=1&size=50&subId=newsletter_2025_05' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json'