How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Criteo Analytics API

The Analytics API from Criteo — 16 operation(s) for analytics.

Criteo Analytics API is one of 13 APIs that Criteo publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Analytics. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a changelog, and authentication docs.

This API exposes 16 operations across 16 paths, and defines 54 schemas. It is described by OpenAPI 3.2.0, at version 2026-07.

Requests are made against a single base URL, https://api.criteo.com.

16 operations 16 paths 54 schemas 2 GET14 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2026-07
Base URL
https://api.criteo.com/2026-07/retail-media
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Criteo Analytics API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (oauth) using the clientCredentials and authorizationCode flows. By default, every request must be authenticated.

Paths & Operations 16

Across 16 paths, the API surfaces 16 operations — 2 GET, 14 POST. Each is listed below with its method, path, parameters, and response codes.

Analytics 16
POST
/2026-07/log-level/advertisers/{advertiser-id}/report
/2026-07/log-level/advertisers/{advertiser-id}/report
GetTransparencyReport 1 param body → 200
POST
/2026-07/placements/report
/2026-07/placements/report
GetPlacementsReport body → 200
POST
/2026-07/statistics/report
/2026-07/statistics/report
GetAdsetReport body → 200
POST
/2026-07/transactions/report
/2026-07/transactions/report
GetTransactionsReport body → 200
GET
/2026-07/retail-media/reports/{reportId}/output
/2026-07/retail-media/reports/{reportId}/output
GetAsyncExportOutput 1 param → 200
GET
/2026-07/retail-media/reports/{reportId}/status
/2026-07/retail-media/reports/{reportId}/status
GetAsyncExportStatus 1 param → 200
POST
/2026-07/retail-media/reports/attributed-transactions
/2026-07/retail-media/reports/attributed-transactions
GenerateAsyncAttributedTransactionsReport body → 200
POST
/2026-07/retail-media/reports/fillrate
/2026-07/retail-media/reports/fillrate
GenerateAsyncFillRateReport body → 200
POST
/2026-07/retail-media/reports/missed-opportunities
/2026-07/retail-media/reports/missed-opportunities
GenerateAsyncMissedOpportunitiesReport body → 200
POST
/2026-07/retail-media/reports/performance
/2026-07/retail-media/reports/performance
GenerateAsyncPerformanceReport body → 200
POST
/2026-07/retail-media/reports/revenue
/2026-07/retail-media/reports/revenue
GenerateAsyncRevenueReport body → 200
POST
/2026-07/retail-media/reports/sync/attributed-transactions
/2026-07/retail-media/reports/sync/attributed-transactions
GenerateSyncAttributedTransactionsReport body → 200
POST
/2026-07/retail-media/reports/sync/campaigns
/2026-07/retail-media/reports/sync/campaigns
GenerateSyncCampaignsReport body → 200
POST
/2026-07/retail-media/reports/sync/line-items
/2026-07/retail-media/reports/sync/line-items
GenerateSyncLineItemsReport body → 200
POST
/2026-07/retail-media/reports/sync/real-time-performance
/2026-07/retail-media/reports/sync/real-time-performance
GenerateSyncRealTimePerformanceReport body → 200
POST
/2026-07/retail-media/reports/unfilled-placements
/2026-07/retail-media/reports/unfilled-placements
GenerateAsyncUnfilledPlacementsReport body → 200

Schemas 54

The contract defines 54 schemas that model the data the API accepts and returns. The most detailed are AsyncRevenueReport (28 properties), PlacementsReportQueryMessage (13 properties), SyncAttributedTransactionsReport (13 properties), SyncLineItemsReport (13 properties). Each schema is shown below with its type and property counts.

TransactionsReportQueryMessageListRequest
object
A top-level object that encapsulates a Criteo API request for several value objects.
1 property
CommonProblem
object
Common problem object.
9 properties
PlacementsReportQueryMessageListRequest
object
A top-level object that encapsulates a Criteo API request for several value objects.
1 property
TransparencyReportFile
object
This is the message defining the file response for Transparency report
2 properties 2 required
TransparencyReportResource
object
A value resource exposed by the API.
2 properties
TransparencyReport
objectnull
This is the message defining the attribute response for Transparency report
3 properties 3 required
StatisticsReportQueryMessage
object
This is the message defining the query for Adset report
11 properties 6 required
PlacementsReportQueryMessage
object
This is the message defining the query for Placements report
13 properties 6 required
TransparencyQueryMessage
object
This is the message defining the query for Transparency report
3 properties 2 required
TransactionsReportQueryMessage
object
This is the message defining the query for Transaction report
7 properties 4 required
PlacementsReportQueryMessageResource
object
A value resource exposed by the API.
2 properties
TransactionsReportQueryMessageResource
object
A value resource exposed by the API.
2 properties
TransparencyReportListResponse
object
A top-level object that encapsulates a Criteo API response for several value objects.
3 properties
AsyncFillRateReport
object
Async FillRate report body request
8 properties 5 required
SyncRealTimePerformanceReportRequest
object
A top-level object that encapsulates a Criteo API request for a single value
1 property
AsyncRevenueReportResource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
SyncRealTimePerformanceReportResource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
SyncAttributedTransactionsReport
object
Attributed Transactions report body request
13 properties 3 required
AsyncFillRateReportResource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
AsyncMissedOpportunitiesReportRequest
object
A top-level object that encapsulates a missed-opportunities async report create request.
1 property
StatusResponseResource
objectnull
A class that represents a domain entity exposed by an API
3 properties
AsyncPerformanceReportRequest
object
A top-level object that encapsulates a performance DSP analytics async report create request.
1 property
SyncAttributedTransactionsReportRequest
object
A top-level object that encapsulates a Criteo API request for a single value
1 property
SyncAttributedTransactionsReportResource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
AsyncUnfilledPlacementsReport
object
Async Unfilled Placements report body request
9 properties 5 required
ReportResponse
object
Report response format
4 properties
AsyncAttributedTransactionsReportResource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
ExportReportMetaData
objectnull
Metadata for a report response: data freshness, column descriptions, and row count.
3 properties
ReportDataResponseResource
objectnull
A top-level object that encapsulates a Criteo API response for a single value
2 properties
SyncCampaignsReport
object
Campaigns report body request
12 properties 3 required
SyncLineItemsReport
object
Line Items report body request
13 properties 3 required
AsyncMissedOpportunitiesReportResource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
AsyncAttributedTransactionsReportRequest
object
A top-level object that encapsulates an attributed-transactions async report create request.
1 property
AsyncPerformanceReportResource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
AsyncUnfilledPlacementsReportResource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
ExportReportColumn
object
Description of a column from an async report request
9 properties 3 required
StatusResponse
objectnull
Status of an async report request
8 properties
AsyncRevenueReportRequest
object
A top-level object that encapsulates a Criteo API request for a single value
1 property
PerformanceReportFilters
object
Array-valued constraints for performance DSP analytics. Exactly one of accountIds, campaignIds, or lineItemIds is required.
12 properties
AsyncMissedOpportunitiesReport
object
Create payload attributes for a missed-opportunities async report.
6 properties 5 required
AsyncRevenueReport
object
Async Revenue report body request
28 properties 2 required
SyncCampaignsReportResource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
AsyncFillRateReportRequest
object
A top-level object that encapsulates a Criteo API request for a single value
1 property
SyncRealTimePerformanceReport
object
Real Time Performance report body request (one sheeter: startDate, endDate (optional), RetailerIds, accountIds, campaignIds, lineItemIds, dimensions, metrics,…
9 properties 1 required
AsyncUnfilledPlacementsReportRequest
object
A top-level object that encapsulates a Criteo API request for a single value
1 property
MissedOpportunitiesReportFilters
object
Array-valued constraints for missed-opportunities reporting. Exactly one of accountIds, campaignIds, or lineItemIds is required.
3 properties
SyncCampaignsReportRequest
object
A top-level object that encapsulates a Criteo API request for a single value
1 property
AttributedTransactionsReportFilters
object
Array-valued constraints for attributed-transactions reporting. Exactly one of accountIds, campaignIds, or lineItemIds is required.
4 properties
AsyncPerformanceReport
object
Create payload attributes for a performance DSP analytics async report.
11 properties 5 required
AsyncAttributedTransactionsReport
object
Create payload attributes for an attributed-transactions async report.
11 properties 5 required
DataCompleteThrough
objectnull
Data freshness: the instant through which report data is complete, expressed in the report's request timezone.
2 properties
SyncLineItemsReportRequest
object
A top-level object that encapsulates a Criteo API request for a single value
1 property
SyncLineItemsReportResource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
AsyncReportResponse
object
Async Report response format
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

criteo-analytics-api-openapi.yml Raw ↑

Other APIs Criteo publishes across the network.

Criteo MCP Servers
Criteo Accounts API
Criteo Advertiser API
Criteo Audience API
Criteo Balance API
Criteo Billing API
Criteo Campaign API
Criteo Catalog API
Criteo Creative API
Criteo Gateway API
Criteo Reco API
Criteo Segment API
Where this information came from

This is an independent, third-party profile of Criteo Analytics API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.