# Instacart — API Agent Score

> Score: 53/100 (Grade: D) | Domain: instacart.com | Rubric: 1.0.0 | Checked: July 24, 2026

Instacart scored 53/100 (D), classified "not-ai-ready".

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

## Summary

- Overall: 53/100 (D)
- Classification: not-ai-ready

## Category Scores

- API Design: 52/100 (D)
- Developer Experience: 72/100 (B)
- Agent Discovery: 73/100 (B)
- Agent Understanding: 50/100 (D)
- Agent Usability: 40/100 (F)

## Check Results

### API Design

- [pass] Example coverage — Code samples in 4 language(s) across docs (top: shell, java, python); 7/20 pages have ≥ 2 languages on the same page. Investigated: docs 100%, sdk 0%.
- [warn] Security & governance hygiene — security.txt present but missing or expired Expires. Investigated: wellknown 50%.
- [fail] Schema coverage & depth — no .d.ts found. Investigated: sdk 0%.
- [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 — Self-service signup at https://www.instacart.com/signup; no free tier or sandbox language detected. Investigated: docs 100%.
- [pass] Code samples in docs — Code samples in 4 language(s) across docs (top: shell, java, python); 7/20 pages have ≥ 2 languages on the same page. Investigated: docs 100%.
- [fail] Quickstart present — No quickstart/getting-started page found at the conventional paths. Investigated: docs 0%.
- [skip] Description completeness — No surface produced evidence for this capability in this run.
- [skip] Changelog published — No surface produced evidence for this capability in this run.

### Agent Discovery

- [warn] Registry & SDK presence — 3/4 registry-metadata components present; missing: keywords. Investigated: sdk 88%, docs 0%, cli 0%, mcp 0%, wellknown 0%.
- [warn] Docs reachable, not hard auth-gated — Server ignores Accept: text/markdown header (0/50 sampled pages return markdown). Investigated: docs 70%.
- [warn] llms.txt present, valid & comprehensive — No llms.txt directive found in HTML of any of 50 sampled pages. Investigated: docs 42%.
- [warn] Crawlable / AEO — Sitemap present (643 entries) but carries no lastmod values. Investigated: wellknown 75%.

### Agent Understanding

- [warn] Agent-navigable, token-efficient docs — 11 of 50 pages have substantive content differences between markdown and HTML (avg 14% missing). Investigated: docs 56%.
- [fail] Agent instructions file (AGENTS.md) — No AGENTS.md at the site root or /.well-known/. Investigated: wellknown 0%.
- [fail] Docs structured data — Neither JSON-LD nor OpenGraph/meta tags detected across 20 sampled pages — likely a CSR-only docs site. Investigated: docs 0%.
- [skip] Machine-readable errors (RFC 9457) — No surface produced evidence for this capability in this run.
- [skip] Operation purpose clarity — No surface produced evidence for this capability in this run.
- [skip] Description consistency across surfaces — Only 1 surface description(s) with ≥6 tokens available; need at least 2 to compare.

### Agent Usability

- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.
- [skip] Idempotency documented — No surface produced evidence for this capability in this run.
- [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.
- [skip] Sandbox separation — No surface produced evidence for this capability in this run.

## Executive Summary

Instacart's API program shows solid discoverability fundamentals, but partners and their AI agents face three critical blockers to successful integration: the API schema lacks the depth and coverage needed for reliable code generation, there are no structured guidance files or runnable examples for agents to act on, and there is no quickstart path to get partners to a first working call quickly. Closing these gaps — starting with schema completeness and agent-readable context, then adding runnable, testable collections — will dramatically accelerate partner onboarding and make Instacart's APIs trustworthy surfaces for AI-driven integration workflows.
