Promotionaloffers
Description
Get the promotions and voucher codes
URL(s)
https://apiv2.effiliation.com/apiv2/commercialtrades.xml?key=YOUR_API_KEY https://apiv2.effiliation.com/apiv2/commercialtrades.csv?key=YOUR_API_KEY https://apiv2.effiliation.com/apiv2/commercialtrades.json?key=YOUR_API_KEY
Parameters
| Parameter | Format | Description | Example value |
|---|---|---|---|
| key | String | Publisher api key | YOUR_API_KEY |
| filter | String | Allows to filter the link list on properties such as activity, publisher programs, effiliation recommandations... | mines(programs I am registered), recommendation(programs I am not registered), active(programs with activity), inactive(programs with no activity) |
| lg | String | Output language | fr, en, es, it, pt, de, nl |
| mode | String | Allows to filter the link list on new programs | new |
| country | String | Allows to filter the link list on coverage countries, several values separated by commas can be set | fr, ge, au, be, da, sp, gr, nl, it, uk, sw, sz, br, bu, cy, en, fi, hu, ei, lg, lh, lu, mt, pl, pt, ro, lo, si, cz, tu |
| categories | String | Allows to filter the link list on advertiser categories id, several values separated by commas can be set | A category ID is an integer value. Check our category API documentation |
| type | String | Allows to filter the link list on link type | cr(reduction code) or bp(good shots) |
| sessions | String | Allows to filter the link list on the given session ids, several values separated by commas can be set | A session ID must be an integer value |
Returned fields
Use fields selector to choose the fields you need. Eg: fields=00101.
| Field | Description | Type | |
|---|---|---|---|
| id_lien | Effiliation link unique ID | Integer | |
| id_affilieur | Effiliation advertiser unique ID | Integer | |
| id_session | Effiliation session unique ID | Integer | |
| id_compteur | Effiliation counter unique ID | Integer | |
| nom | Link name | String | |
| date_debut | Link begin date | Date | |
| date_fin | Link end date | Date | |
| nomprogramme | Program name | String | |
| site_affilieur | Advertiser site name | String | |
| url_affilieur | Advertiser url | String | |
| url_logo | Advertiser logo url | String | |
| type | Trade type | String | |
| intitule | Link title | String | |
| description | Link description | String | |
| exclusivite | Indicates whether the link is an Effiliation exclusive link | String | |
| url_redir | Link redirection url | String | |
| code | Link code | String | |
| id_programme | Program unique ID | Integer |
Examples
An XML feed with all my commercial trades
https://apiv2.effiliation.com/apiv2/commercialtrades.xml?key=YOUR_API_KEY&filter=mines
An XML feed with all my new commercial trades
https://apiv2.effiliation.com/apiv2/commercialtrades.xml?key=YOUR_API_KEY&filter=mines&mode=new
A CSV feed with all my reduction codes
https://apiv2.effiliation.com/apiv2/commercialtrades.csv?key=YOUR_API_KEY&filter=mines&type=cr
A JSON feed with good shots I'm not registered
https://apiv2.effiliation.com/apiv2/commercialtrades.json?key=YOUR_API_KEY&filter=recommendation&type=bp
An XML feed with all my new french and german commercial trades
https://apiv2.effiliation.com/apiv2/commercialtrades.xml?key=YOUR_API_KEY&filter=mines&mode=new&country=fr,ge