Discard

Criteo Marketing Solutions API

Migration Guide for PAPI Users

Are you a PAPI user? This article has an overview of the Criteo API endpoints you can use to replace your PAPI connections. This will help you migrate before the PAPI deprecation by June 2021.

First, you will need to complete your onboarding in our new Developer Portal as indicated in the onboarding checklist. Then, you will be ready to start migrating your PAPI endpoints.

Below, you can see the Criteo API's equivalent for your PAPI endpoints.

PAPI

Criteo API equivalent

getAccount

Retrieves generic information about the advertiser (name, email of the primary admin, currency, timezone, and country)

/advertisers/me

Retrieve your advertisers' ids and names. This endpoint does not include the email of the primary admin, currency, timezone, or country information

getCampaigns

Returns the campaigns of the advertiser (can query one or more)

/marketing-solutions/ad-sets/search

Retrieve your adSet for a specific advertiser

getCategories
Returns all categories for all the partners of the advertiser

/advertiser/{advertiserid}/categories

Retrieve your campaigns and categories for a specific advertiser
Filter result per category status

Available soon

getBudgets

Returns the budgets of the advertiser (can query one or more)

/marketing-solutions/ad-sets/search

Retrieve budgets for your portfolio

getStatisticsLastUpdate

Returns the max date available in the statistics storage

This field is not relevant anymore. This was necessary in PAPI due to the asynchronous nature of the Statistics reports. Through the Criteo API, reports are instead pulled in real-time.

mutateCampaigns

Changes the CPC of one or more campaigns and of their associated categories

/marketing-solutions/ad-sets

Set new bid values to your campaign.

Bidding per category will be available soon.

mutateCategories

Enables/disables the ability to bid on a category

/categories
Update Category-Level bids for a Campaign

Available soon

scheduleReportJob

Launches the generation of a statistics report along with the dimension Campaign or Category, with the granularity Day or Hour, for a given time period.

/preview/statistics/report

Retrieve data related to your campaigns' performance. You can customize the specific metrics returned and the dimensions that the data is grouped by (including all the previous dimensions and temporal granularity)

Updated 17 days ago


Migration Guide for PAPI Users


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.