To use our REST API, you will need to create a new API User in our Criteo Management Center platform. You can access this platform at: https://marketing.criteo.com/
When logged in:
- Click on Setup > Users
- Then click on CREATE API USER
- You will then need to enter a contact Email address and select one of the following roles: View only, Business Manager, Finance Manager. To be able to use our API, please pick the Business Manager The View only and Finance Manager roles don’t have enough privileges to input and pull data through our API.
- When done, click Add user. You will receive a confirmation message, your Client ID and Client Secret. Store them carefully as you will need them to post requests to our API.
All amounts expressed in the Criteo REST API, be it:
- Performance numbers (e.g. COS, Spend, …),
- Budgets and bids
are expressed in your local currency.
NOTE: You can check your local currency in our Management Center interface. Under “Setup,” select “Users” and select the desired user.
All dates in the Criteo REST API are shown in Coordinated Universal Time (UTC).
Remaining budget and statistics are not real-time and can have up to a few hours of delay. Hence a seller can be inactive while its remaining amount is still decreasing. The sellers’ ads are not displayed anymore, but the remaining budget is decreasing as data is catching up.
API USAGE RECOMMENDATION
When updating large batches of budgets or bids, you should implement these changes in two separate, batched API calls as opposed to many individual calls as this may lead to throttling. One call should be marked for bids and another call for budgets. Both calls will contain the correct bids and budgets for the respective campaign.
EXAMPLE: You need to set bids and budgets for 10 different sellers. We recommend you send 1 API call for bids endpoint and 1 API call for budgets endpoint, with both containing respective sellers desired bids and budgets.