# Oxylabs — API Agent Score

> Score: 91/100 (Grade: A+) | Domain: oxylabs.io | Rubric: 1.0.0 | Checked: October 23, 2026

Oxylabs scored 91/100 (A+), classified "ai-ready".

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

## Summary

- Overall: 91/100 (A+)
- Classification: ai-ready

## Category Scores

- API Design: 92/100 (A+)
- Developer Experience: 100/100 (A+)
- Agent Discovery: 93/100 (A+)
- Agent Understanding: 87/100 (A)
- Agent Usability: 85/100 (A)

## Check Results

### API Design

- [warn] Schema coverage & depth — 11 of 59 public signatures use loose types (anyTypeRatio=0.186). Investigated: sdk 82%.
- [pass] Security & governance hygiene — Code is formatter-clean with zero linter errors and zero style warnings. Investigated: sdk 100%, wellknown 0%.
- [pass] Example coverage — Docs show code samples in 8 language(s) (top: shell, python, curl), and 3 of 19 sampled pages offer ≥ 2 languages side by side. Investigated: docs 100%, sdk 100%.
- [skip] Machine-readable, versioned contract — No surface produced evidence for this capability in this run.
- [skip] Auth declared & discoverable — No surface produced evidence for this capability in this run.

### Developer Experience

- [pass] Self-service developer portal — Signup page found at https://oxylabs.io/resources/start-guides, 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://developers.oxylabs.io/get-started/quick-start-web-api has a runnable code sample in its plain-text .md variant (https://developers.oxylabs.io/get-started/quick-start-web-api.md). Investigated: docs 100%.
- [pass] Code samples in docs — Docs show code samples in 8 language(s) (top: shell, python, curl), and 3 of 19 sampled pages offer ≥ 2 languages side by side. Investigated: docs 100%.
- [pass] Description completeness — 21/21 operations carry a description. Investigated: sdk 100%.
- [skip] Changelog published — No surface produced evidence for this capability in this run.

### 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_oxylabs_io, 4892 snippets). Investigated: docs 100%, cli 100%, sdk 83%.
- [warn] llms.txt present, valid & comprehensive — llms.txt covers 260/462 sitemap doc pages (56%); 202 missing; 6 llms.txt links not in sitemap (may indicate stale links or incomplete sitemap) — Missing: https://developers.oxylabs.io, https://developers.oxylabs.io/documentation/cn, https://developers.oxylabs.io/documentation/cn/changelog, https://developers.oxylabs.io/documentation/cn/kai-shi-shi-yong/kuai-su-kai-shi-web-api, https://developers.oxylabs.io/documentation/cn/kai-shi-shi-yong/quick-start-proxies (and 45 more). Investigated: docs 85%, sdk 0%.
- [warn] Crawlable / AEO — Sitemap has 15 entries but no lastmod values, so crawlers can't tell what changed recently. Investigated: wellknown 75%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — Single base error "ConfigurationError" with 8 subclasses. Investigated: sdk 100%.
- [pass] Operation purpose clarity — Surface uses a single dominant casing convention (camelCase). Investigated: sdk 100%.
- [warn] Agent-navigable, token-efficient docs — 7 of 50 pages have substantive content differences between markdown and HTML (avg 9% missing). Investigated: docs 94%.
- [warn] Agent instructions file (AGENTS.md) — No agents.md or skill.md context file found (nice-to-have for agent operation). Investigated: sdk 50%, wellknown 0%.
- [warn] Docs structured data — Only OpenGraph/meta tags across 3 assessed pages — no JSON-LD for AI answer engines to cite. Investigated: docs 50%.
- [warn] Description consistency across surfaces — Mean pairwise description similarity across 2 surfaces (docs, sdk) is 10% (threshold 35% for full credit).

### Agent Usability

- [pass] Idempotency documented — Built-in retry machinery is present (grep-derived). Investigated: sdk 100%.
- [warn] Sandbox separation — No test-mode flag or sandbox environment is exposed. Investigated: sdk 50%.
- [pass] Runnable collection with test scripts — README is present and includes a runnable quickstart. Investigated: sdk 100%, platform 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

Oxylabs' API program is performing strongly overall, with agent discoverability and API design already at high levels. The areas with the most room to sharpen partner outcomes are agent understanding — ensuring partners and their AI agents can parse, interpret, and act on your docs and errors without ambiguity — and agent usability, where runnable, trustworthy context accelerates real integrations. Prioritizing structured, machine-readable documentation and safe, executable onboarding will solidify Oxylabs as a best-in-class partner API program.