Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

HookLogic (Criteo) Analytics API

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

HookLogic (Criteo) Analytics API is one of 8 APIs that HookLogic (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, and an API reference.

This API exposes 12 operations across 12 paths, and defines 42 schemas. It is described by OpenAPI 3.0.1, at version 2026-07.

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

12 operations 12 paths 42 schemas 2 GET10 POST

Metadata

The identity and technical contract details declared by the specification.

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

Authentication & Security 1

HookLogic (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 12

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

Analytics 12
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 42

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

SyncAttributedTransactionsReportRequest
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
MissedOpportunitiesReportFilters
object
Array-valued constraints for missed-opportunities reporting. At least one of accountIds, campaignIds, or lineItemIds is required.
4 properties
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
AsyncUnfilledPlacementsReportResource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
StatusResponse
object
Status of an async report request
8 properties
SyncCampaignsReportResource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
SyncLineItemsReport
object
Line Items report body request
13 properties 3 required
ReportDataResponseResource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
SyncCampaignsReportRequest
object
A top-level object that encapsulates a Criteo API request for a single value
1 property
CommonProblem
object
Common problem object.
9 properties
AsyncUnfilledPlacementsReportRequest
object
A top-level object that encapsulates a Criteo API request for a single value
1 property
SyncAttributedTransactionsReport
object
Attributed Transactions report body request
13 properties 3 required
AsyncPerformanceReport
object
Create payload attributes for a performance DSP analytics async report.
11 properties 5 required
AsyncPerformanceReportResource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
AttributedTransactionsReportFilters
object
Array-valued constraints for attributed-transactions reporting. At least one of accountIds, campaignIds, or lineItemIds is required.
4 properties
AsyncRevenueReportRequest
object
A top-level object that encapsulates a Criteo API request for a single value
1 property
AsyncFillRateReportRequest
object
A top-level object that encapsulates a Criteo API request for a single value
1 property
AsyncFillRateReport
object
Async FillRate report body request
8 properties 5 required
AsyncAttributedTransactionsReport
object
Create payload attributes for an attributed-transactions async report.
11 properties 5 required
ReportResponse
object
Report response format
4 properties
AsyncMissedOpportunitiesReportResource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
StatusResponseResource
object
A class that represents a domain entity exposed by an API
3 properties
ExportReportColumn
object
Description of a column from an async report request
9 properties 3 required
AsyncAttributedTransactionsReportResource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
AsyncPerformanceReportRequest
object
A top-level object that encapsulates a performance DSP analytics async report create request.
1 property
SyncAttributedTransactionsReportResource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
AsyncRevenueReportResource
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
AsyncUnfilledPlacementsReport
object
Async Unfilled Placements report body request
9 properties 5 required
DataCompleteThrough
object
Data freshness: the instant through which report data is complete, expressed in the report's request timezone.
2 properties
SyncCampaignsReport
object
Campaigns report body request
12 properties 3 required
SyncLineItemsReportRequest
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. At least one of accountIds, campaignIds, or lineItemIds is required.
12 properties
SyncRealTimePerformanceReportResource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
SyncRealTimePerformanceReport
object
Real Time Performance report body request (one sheeter: startDate, endDate (optional), RetailerIds, accountIds, campaignIds, lineItemIds, dimensions, metrics,…
9 properties 1 required
SyncRealTimePerformanceReportRequest
object
A top-level object that encapsulates a Criteo API request for a single value
1 property
AsyncMissedOpportunitiesReport
object
Create payload attributes for a missed-opportunities async report.
6 properties 5 required
AsyncAttributedTransactionsReportRequest
object
A top-level object that encapsulates an attributed-transactions async report create request.
1 property
ExportReportMetaData
object
Metadata for a report response: data freshness, column descriptions, and row count.
3 properties
AsyncRevenueReport
object
Async Revenue report body request
28 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hooklogic-criteo-analytics-api-openapi.yml Raw ↑

Other APIs HookLogic (Criteo) publishes across the network.

HookLogic (Criteo) Accounts API
HookLogic (Criteo) Audience API
HookLogic (Criteo) Balance API
HookLogic (Criteo) Billing API
HookLogic (Criteo) Campaign API
HookLogic (Criteo) Catalog API
HookLogic (Criteo) Gateway API