Simple REST API to get all your statistics and transactions programmatically.
Authorization
For your authorization, you need a token. In order to receive a token please read advanced API - Get an access token.
SiteIds
The siteId is a unique identifier of your registered ad spaces. You'll find the ID in the user interface. You can request one or multiple site Ids in the same request.
Endpoint
https://api.advanced-store.com/publishers/transactions/2.0/
โExample request
curl --location 'https://api.advanced-store.com/publishers/transactions/2.0/?endDate=1701176201&startDate=1698793200&size=100&page=1&siteIds=1267%2C25' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer *************'
GET parameters reference
Name | Description |
|
page | Page number for the pagination | integer, mandatory |
size | Set the page size | integer, mandatory
Max value of 250 is recommended |
siteIds | Ids of all pages you like to include in the response | mandatory |
startDate | Timestamp of the starting date | mandatory |
endDate | Timestamp of the ending date | mandatory |
programId | Id if you like to filter for a single program | optional |
statusId |
| optional |
dateRangeType | Reference for the start and end date | optional
The default is 'updatedAt' |
Example response:
โ
{
"totalEntries": 2,
"currentPage": 1,
"totalPageCount": 1,
"pageSize": 10,
"transactionDataList": [
{
"transactionDate": 1699114860000,
"commission": X.XX,
"basketValue": XXX.XX,
"clickTime": 1697899620000,
"program": "XXX",
"programId": "28649",
"site": "XXX",
"siteId": "25",
"status": "pending",
"subIdOrText": "SUMMERCAMPAIGN2",
"transactionId": "1454126308",
"transactionType": "sale(PC)",
"trackingCategory": "Full price item",
"updatedAt": 1699117069561,
"conversionTime": "0d 0h 1m 50s"
},
{
"transactionDate": 1700059140000,
"commission": X.XX,
"basketValue": XXX.XX,
"clickTime": 1700057400000,
"program": "XXX",
"programId": "28649",
"site": "XXX",
"siteId": "25",
"status": "pending",
"subIdOrText": "SUMMERCAMPAIGN1",
"transactionId": "1463351349",
"transactionType": "sale(PC)",
"trackingCategory": "Full price item",
"updatedAt": 1700067702247,
"conversionTime": "0d 0h 1m 50s"
}]
}
Answer Explanation
status
pending - transaction is still open
rejected - transaction is rejected by advertiser
confirmed - transaction is approved but not paid
paid - transaction is paid out