# Contentsquare — API Agent Score

> Score: 69/100 (Grade: C) | Domain: contentsquare.com | Rubric: 1.0.0 | Checked: September 21, 2026

Contentsquare scored 69/100 (C), classified "partially-ready".

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

## Summary

- Overall: 69/100 (C)
- Classification: partially-ready

## Category Scores

- API Design: 71/100 (B)
- Developer Experience: 85/100 (A)
- Agent Discovery: 89/100 (A)
- Agent Understanding: 69/100 (C)
- Agent Usability: 48/100 (F)

## Check Results

### API Design

- [warn] Schema coverage & depth — 4 of 19 public signatures use loose types (anyTypeRatio=0.211). Investigated: sdk 83%.
- [warn] Machine-readable, versioned contract — `--help --format json` exits 0 but output is not JSON. Investigated: cli 75%.
- [pass] Security & governance hygiene — Code is formatter-clean with zero linter errors and zero style warnings. Investigated: sdk 100%, wellknown 100%.
- [pass] Example coverage — Docs show code samples in 4 language(s) (top: shell, javascript, swift), and 4 of 20 sampled pages offer ≥ 2 languages side by side. Investigated: docs 100%, sdk 50%, cli 0%.
- [fail] Auth declared & discoverable — no auth/config hint in --help. Investigated: cli 0%.

### Developer Experience

- [pass] Self-service developer portal — Signup page found at https://app.contentsquare.com/signup?cs_lite=1&utm_source=csq_website, but no free tier or sandbox is documented in docs/pricing, so an agent may hit a paywall. Investigated: docs 100%.
- [pass] Quickstart present — Quickstart at https://docs.contentsquare.com/en/csq-sdk-android/product-analytics/index includes a runnable first-call code sample. Investigated: docs 100%.
- [pass] Code samples in docs — Docs show code samples in 4 language(s) (top: shell, javascript, swift), and 4 of 20 sampled pages offer ≥ 2 languages side by side. Investigated: docs 100%.
- [fail] Description completeness — 11/11 operations lack a description. Investigated: sdk 0%.
- [skip] Changelog published — No surface produced evidence for this capability in this run.

### Agent Discovery

- [pass] Registry & SDK presence — Indexed on Context7 (llmstxt/contentsquare_llms_txt, 5176 snippets). Investigated: docs 100%, sdk 58%, cli 0%, mcp 0%, wellknown 0%.
- [warn] llms.txt present, valid & comprehensive — llms.txt covers 283/372 sitemap doc pages (76%); 89 missing. Investigated: docs 81%, sdk 0%.
- [warn] Docs reachable, not hard auth-gated — Server ignores Accept: text/markdown header (0/50 sampled pages return markdown). Investigated: docs 75%.
- [pass] Crawlable / AEO — robots.txt lets all monitored AI crawlers reach the docs paths. Investigated: wellknown 100%.

### Agent Understanding

- [pass] Operation purpose clarity — Surface uses a single dominant casing convention (camelCase). Investigated: sdk 100%.
- [warn] Agent-navigable, token-efficient docs — 5 of 50 pages have minor content differences between markdown and HTML. Investigated: docs 89%.
- [pass] Docs structured data — Machine-readable JSON-LD Article markup on 20 of 20 assessed pages (100%), with dateModified present. Investigated: docs 100%.
- [warn] Agent instructions file (AGENTS.md) — No agents.md or skill.md context file found (nice-to-have for agent operation). Investigated: sdk 50%, cli 0%, wellknown 0%.
- [warn] Description consistency across surfaces — Mean pairwise description similarity across 2 surfaces (docs, sdk) is 17% (threshold 35% for full credit).
- [fail] Machine-readable errors (RFC 9457) — errors are prose, not a structured envelope. Investigated: cli 0%.

### Agent Usability

- [warn] Sandbox separation — No test-mode flag or sandbox environment is exposed. Investigated: sdk 50%.
- [warn] Runnable collection with test scripts — README is present but has no runnable quickstart. Investigated: sdk 50%, platform 0%.
- [fail] Idempotency documented — No built-in retry machinery was found; transient failures are not retried. Investigated: sdk 0%, cli 0%.
- [skip] Rate-limit signaling — No surface produced evidence for this capability in this run.
- [skip] Pagination documented & consistent — No surface produced evidence for this capability in this run.

## Executive Summary

Contentsquare's API program shows strong discoverability and a solid foundational contract, but two areas are holding back partner and agent adoption: every single API operation is undocumented, leaving partners and their AI agents with no context to build against, and error responses are unstructured prose that agents cannot parse or act on reliably. Fixing operation-level documentation and machine-readable error semantics — alongside surfacing auth configuration and idempotency guarantees — will unlock self-serve onboarding and let partners' AI agents integrate with confidence rather than guesswork.