# Criteo — API Agent Score

> Score: 77/100 (Grade: B) | Domain: criteo.com | Rubric: 1.0.0 | Checked: August 3, 2026

Criteo scored 77/100 (B), classified "partially-ready".

[View full report](https://www.postman.com/ai/ai-ready-apis/company/criteo)
[All organizations](https://www.postman.com/ai/ai-ready-apis/llms.txt)

## Summary

- Overall: 77/100 (B)
- Classification: partially-ready

## Category Scores

- API Design: 84/100 (A)
- Developer Experience: 66/100 (C)
- Agent Discovery: 93/100 (A+)
- Agent Understanding: 90/100 (A+)
- Agent Usability: 58/100 (D)

## Check Results

### API Design

- [pass] Machine-readable, versioned contract — API versioning documented in the docs site at https://developers.criteo.com/criteo-apis/docs/versioning-policy. Investigated: spec 100%, docs 100%.
- [pass] Auth declared & discoverable — Authentication required (global or on every operation). Investigated: docs 100%, spec 50%, wellknown 0%.
- [warn] Schema coverage & depth — 93% of operations have documented schemas (target 95%+). Investigated: spec 67%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 100%.
- [fail] Example coverage — 0% example coverage. Investigated: spec 0%, docs 0%.

### Developer Experience

- [pass] Self-service developer portal — Self-service signup at https://www.criteo.com/talk-to-an-expert/; no free tier or sandbox language detected. Investigated: docs 100%.
- [pass] Description completeness — 99% of operations + parameters have substantive descriptions. Investigated: spec 100%.
- [pass] Changelog published — changelog documented in the docs site at https://developers.criteo.com/marketing-solutions/changelog/changelog. Investigated: spec 100%, docs 100%, sdk 100%.
- [fail] Quickstart present — No quickstart/getting-started page found at the conventional paths. Investigated: docs 0%.
- [fail] Code samples in docs — No detectable code samples across 20 sampled docs pages. Investigated: docs 0%.

### Agent Discovery

- [pass] Docs reachable, not hard auth-gated — All 50 sampled pages are publicly accessible. Investigated: docs 100%.
- [pass] Registry & SDK presence — Indexed on Context7 (websites/developers_criteo_marketing-solutions, 1201 snippets). Investigated: docs 100%, sdk 100%, cli 0%.
- [warn] llms.txt present, valid & comprehensive — llms.txt covers 194/2500 sitemap doc pages (8%); 2306 missing. Investigated: docs 75%.
- [pass] Crawlable / AEO — Docs paths crawlable by all monitored AI agents. Investigated: wellknown 100%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — error codes documented in the docs site at https://developers.criteo.com/criteo-apis/docs/api-error-codes. Investigated: spec 100%, docs 100%.
- [pass] Operation purpose clarity — 100% of operations have a clear summary + operationId an agent can select on. Investigated: spec 100%.
- [warn] Agent-navigable, token-efficient docs — 9 of 50 pages have minor content differences between markdown and HTML. Investigated: docs 95%.
- [pass] Docs structured data — JSON-LD Article markup on 18/18 assessed pages (100%) with dateModified present. Investigated: docs 100%.
- [fail] Agent instructions file (AGENTS.md) — No AGENTS.md at the site root or /.well-known/. Investigated: wellknown 0%.
- [skip] Description consistency across surfaces — Only 1 surface description(s) with ≥6 tokens available; need at least 2 to compare.

### Agent Usability

- [pass] Rate-limit signaling — rate-limit behavior documented in the docs site at https://developers.criteo.com/retail-media/v2026.07/reference/analytics/2026-07retail-mediareportsattributed-transactions. Investigated: spec 100%, docs 100%.
- [pass] Pagination documented & consistent — Pagination params detected on 15 list endpoint(s). Investigated: spec 100%, docs 100%.
- [fail] Idempotency documented — 0% of mutating operations document idempotency. Investigated: spec 0%, docs 0%.
- [fail] Sandbox separation — No sandbox/test server declared across 1 server entries; no test-key prefixes documented. Investigated: spec 0%, docs 0%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.

## Executive Summary

Criteo's API program shows strong foundations in documentation discovery and schema design, but partner onboarding and agent usability are materially at risk. Partners and their AI agents currently lack runnable examples, a sandbox, and a quickstart path — meaning integration requires guesswork and direct support rather than self-serve success. The highest-priority work is making APIs executable and trustworthy for both human developers and coding agents, starting with a sandboxed runnable experience and rich example coverage across the spec and docs.