# Bright Data — API Agent Score

> Score: 80/100 (Grade: A) | Domain: brightdata.com | Rubric: 1.0.0 | Checked: July 24, 2026

Bright Data scored 80/100 (A), classified "ai-ready".

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

## Summary

- Overall: 80/100 (A)
- Classification: ai-ready

## Category Scores

- API Design: 93/100 (A+)
- Developer Experience: 61/100 (C)
- Agent Discovery: 91/100 (A+)
- Agent Understanding: 68/100 (C)
- Agent Usability: 84/100 (A)

## Check Results

### API Design

- [pass] Auth declared & discoverable — Authentication required (global or on every operation). Investigated: spec 100%, docs 100%.
- [warn] Schema coverage & depth — 6 of 271 public signatures use loose types (anyTypeRatio=0.022). Investigated: sdk 92%, spec 67%.
- [warn] Machine-readable, versioned contract — info.version="1.0.0" set but no versioning scheme (URL / header / media type) detected. Investigated: spec 75%, docs 50%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 0%.
- [pass] Example coverage — 46% example coverage. Investigated: spec 100%, sdk 100%, docs 0%.

### Developer Experience

- [pass] Self-service developer portal — Signup page at https://brightdata.com/ (CSR-rendered — body classifier inconclusive); free tier / sandbox documented in pricing/docs. Investigated: docs 100%.
- [pass] Changelog published — changelog documented in the docs site at https://docs.brightdata.com/release-notes. Investigated: spec 100%, docs 100%, sdk 100%.
- [warn] Description completeness — 46/102 operations lack a description. Investigated: sdk 55%, spec 17%.
- [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 1 pages are publicly accessible. Investigated: docs 100%.
- [pass] Registry & SDK presence — Indexed on Context7 (websites/brightdata, 12240 snippets). Investigated: docs 100%, sdk 100%, cli 100%, mcp 50%, wellknown 0%.
- [warn] llms.txt present, valid & comprehensive — No /llms-full.txt found at the candidate origins. Investigated: docs 67%, sdk 0%.
- [pass] Crawlable / AEO — Docs paths crawlable by all monitored AI agents. Investigated: wellknown 100%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — 4 distinct 4xx/5xx response codes documented. Investigated: docs 100%, sdk 100%, spec 50%.
- [warn] Agent-navigable, token-efficient docs — 1 of 1 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%.
- [warn] Description consistency across surfaces — Mean pairwise description similarity across 3 surfaces (spec, docs, sdk) is 19% (threshold 35% for full credit).
- [fail] Operation purpose clarity — 0% of operations are agent-inferable. Investigated: spec 0%.
- [fail] Agent instructions file (AGENTS.md) — No AGENTS.md at the site root or /.well-known/. Investigated: wellknown 0%.

### Agent Usability

- [pass] Idempotency documented — Built-in retry machinery is present (grep-derived). Investigated: sdk 100%, spec 0%, docs 0%.
- [pass] Rate-limit signaling — rate-limit behavior documented in the docs site at https://docs.brightdata.com/general/account/limited-trial-restrictions. Investigated: spec 100%, docs 100%.
- [pass] Pagination documented & consistent — pagination documented in the docs site at https://docs.brightdata.com/ai/mcp-server/integrations/cursor. Investigated: docs 100%, spec 67%.
- [warn] Sandbox separation — No test-mode flag or sandbox environment is exposed. Investigated: sdk 50%, spec 0%, docs 0%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.

## Executive Summary

Brightdata's API program shows strong foundations in API design, agent discovery, and overall usability — partners can find and call the APIs reliably. The most urgent gaps are in agent understanding and developer onboarding: operations lack clear semantic purpose descriptions and there is no structured agent instructions file, meaning AI coding agents cannot reliably interpret or act on the API surface without guessing. Compounding this, partners have no quickstart path or inline code samples to get hands-on quickly, and runnable collections with test scripts are absent — leaving both humans and agents without verified, executable context. Prioritize closing the agent-understanding gaps and onboarding shortfalls first, then layer in runnable, test-backed collections to complete the picture.