instacart website screenshot

instacart

Use the public Instacart APIs to add Instacart shopping capabilities to your applications, such as product shopping lists and recipe ingredients.

instacart publishes 9 APIs on the APIs.io network, including Authentication API, Chat API, Delivery API, and 6 more.

The instacart catalog on APIs.io includes 1 event-driven AsyncAPI specification, 1 JSON-LD context, and 2 Spectral governance rulesets.

instacart’s developer surface includes authentication and 8 more developer resources.

🌐 Visit website 📡 Source on GitHub
41.3/100 thin ▬ flat Agent 43/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessSelf serve
10 APIs

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 41.3/100 · thin
Contract Quality 19.9 / 25
Developer Ergonomics 2.2 / 20
Commercial Clarity 5.8 / 20
Operational Transparency 3.4 / 13
Governance 5.0 / 12
Discoverability 5.0 / 10
Agent readiness — 43/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 6 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/instacart: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 10

Individual APIs this provider publishes, each with its own machine-readable definition.

Instacart Shopping Widgets

Instacart Shopping Widgets are front-end web components that retailers can embed into their websites to add e-commerce functionalities powered by Instacart without interacting w...

instacart Authentication API

Endpoints for obtaining and managing OAuth 2.0 access tokens used to authenticate API requests.

instacart Chat API

Endpoints for shopper-customer communication including sending and retrieving chat messages.

instacart Delivery API

Endpoints for finding delivery stores, previewing time slots, reserving time slots, and creating delivery orders.

instacart Items API

Endpoints for updating item-level attributes such as pricing and availability at specific store locations. Items contain information that can vary from one store to another.

instacart Last Mile Delivery API

Endpoints for last mile delivery where items are pre-packed and only require delivery from the store to the customer.

instacart Orders API

Endpoints for retrieving order status, handling details, and item information after checkout.

instacart Pickup API

Endpoints for finding pickup stores, previewing time slots, reserving time slots, and creating pickup orders.

instacart Products API

Endpoints for creating and updating products in the retailer's catalog on Instacart. Products are the same across all of a retailer's stores.

instacart Replacements API

Endpoints for managing item replacements suggested by shoppers during order fulfillment.

Scroll for all 10

Open Collections 4

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Instacart Catalog API

OPEN COLLECTION

Instacart Connect Fulfillment API

OPEN COLLECTION

Instacart Connect Post-Checkout API

OPEN COLLECTION

Instacart Developer Platform API

OPEN COLLECTION

GraphQL 1

GraphQL schemas published by this provider.

Instacart GraphQL Schema

This conceptual GraphQL schema models the Instacart grocery delivery and retail platform. Instacart provides APIs for retailers, brands, and developers to integrate grocery shop...

GRAPHQL

Pricing Plans 1

Published pricing tiers and plan structures.

Instacart Plans Pricing

2 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Instacart Rate Limits

1 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Instacart Finops

FINOPS

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Instacart Connect Event Callbacks

Instacart Connect notifies retailers of order status changes and fulfillment events through webhook callbacks. Retailers configure callback endpoints to receive real-time notifi...

ASYNCAPI

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Instacart Context

0 classes · 8 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

instacart API Rules

8 rules · 1 errors 7 warnings

SPECTRAL

instacart API Rules

6 rules · 5 warnings 1 info

SPECTRAL

JSON Schema 35

Standalone JSON Schema definitions for this provider's data models.

CartItem

3 properties

JSON SCHEMA

ChatMessage

4 properties

JSON SCHEMA

ChatMessagesResponse

1 properties

JSON SCHEMA

CreateOrderRequest

4 properties

JSON SCHEMA

Error

2 properties

JSON SCHEMA

FindStoresRequest

7 properties

JSON SCHEMA

Ingredient

6 properties

JSON SCHEMA

Item

10 properties

JSON SCHEMA

ItemSubmissionRequest

1 properties

JSON SCHEMA

LineItem

8 properties

JSON SCHEMA

Instacart Order

12 properties

JSON SCHEMA

OrderHandlingResponse

6 properties

JSON SCHEMA

OrderItem

5 properties

JSON SCHEMA

OrderItemsResponse

1 properties

JSON SCHEMA

OrderResponse

7 properties

JSON SCHEMA

PostCheckoutOrderItem

6 properties

JSON SCHEMA

PreviewServiceOptionsRequest

2 properties

JSON SCHEMA

Instacart Product

12 properties

JSON SCHEMA

ProductsLinkResponse

1 properties

JSON SCHEMA

ProductSubmissionRequest

1 properties

JSON SCHEMA

RecipeRequest

10 properties

JSON SCHEMA

Replacement

3 properties

JSON SCHEMA

ReplacementDecisionRequest

1 properties

JSON SCHEMA

ReplacementResponse

2 properties

JSON SCHEMA

ReserveTimeSlotRequest

2 properties

JSON SCHEMA

SendMessageRequest

1 properties

JSON SCHEMA

ServiceOption

5 properties

JSON SCHEMA

ServiceOptionHoldResponse

3 properties

JSON SCHEMA

ServiceOptionsResponse

1 properties

JSON SCHEMA

ShoppingListRequest

7 properties

JSON SCHEMA

Store

4 properties

JSON SCHEMA

StoresResponse

1 properties

JSON SCHEMA

SubmissionResponse

4 properties

JSON SCHEMA

TokenRequest

4 properties

JSON SCHEMA

TokenResponse

5 properties

JSON SCHEMA

Scroll for all 35

JSON Structure 1

JSON Structure definitions describing this provider's data shapes.

Instacart Structure

0 properties

JSON STRUCTURE

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Instacart Authentication

apiKey/http · 2 schemes

SECURITY

Instacart Domain Security

TLSv1.2 · DMARC

SECURITY

Instacart Vulnerability Disclosure

Hackerone · security.txt · contact published

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Instacart Agentic Access

23 operations · 19 acting

23 operations · 19 acting

AGENTIC

Resources

Documentation 2

Reference material describing how the API behaves

JSONSchema
JSONSchema
 JSONSchema
JSONSchema

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Design & Contract 1

Pagination, idempotency, versioning, errors, and events

JSONLD
JSONLD

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization

Access & Security 3

Authentication, authorization, and security posture

VulnerabilityDisclosure
VulnerabilityDisclosure
 DomainSecurity
DomainSecurity
 Authentication
Authentication

Company 1

The organization behind the API

LinkedIn
LinkedIn

Source (apis.yml)

apis.yml Raw ↑ 
aid: instacart
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/instacart.png
url: https://raw.githubusercontent.com/api-evangelist/instacart/refs/heads/main/apis.yml
modified: '2026-05-19'
apis:
- aid: instacart:shopping-widgets
  name: Instacart Shopping Widgets
  tags:
  - Embedding
  - Retail
  - Shopping
  - Web Components
  - Widgets
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  baseURL: https://api.example.com
  humanURL: https://docs.instacart.com/widgets/
  properties:
  - url: https://docs.instacart.com/widgets/
    type: Documentation
  description: Instacart Shopping Widgets are front-end web components that retailers can embed into their websites to add
    e-commerce functionalities powered by Instacart without interacting with any API directly. The widgets enable features
    such as product search results, cart management, product collections, and user authentication.
- aid: instacart:instacart-authentication-api
  name: instacart Authentication API
  description: Endpoints for obtaining and managing OAuth 2.0 access tokens used to authenticate API requests.
  humanURL: https://docs.instacart.com/developer_platform_api/
  baseURL: https://connect.instacart.com
  tags:
  - Authentication
  properties:
  - type: OpenAPI
    url: openapi/instacart-authentication-api-openapi.yml
  - type: Documentation
    url: https://docs.instacart.com/developer_platform_api/
  - type: GraphQL
    url: graphql/instacart-graphql.md
  - type: Documentation
    url: https://docs.instacart.com/connect/fulfillment/
  - type: AsyncAPI
    url: asyncapi/instacart-connect-events-asyncapi.yml
  - type: Documentation
    url: https://docs.instacart.com/connect/post-checkout/
  - type: Documentation
    url: https://docs.instacart.com/catalog/catalog_api/overview/
- aid: instacart:instacart-chat-api
  name: instacart Chat API
  description: Endpoints for shopper-customer communication including sending and retrieving chat messages.
  humanURL: https://docs.instacart.com/developer_platform_api/
  baseURL: https://connect.instacart.com
  tags:
  - Chat
  properties:
  - type: OpenAPI
    url: openapi/instacart-chat-api-openapi.yml
  - type: Documentation
    url: https://docs.instacart.com/developer_platform_api/
  - type: GraphQL
    url: graphql/instacart-graphql.md
  - type: Documentation
    url: https://docs.instacart.com/connect/fulfillment/
  - type: AsyncAPI
    url: asyncapi/instacart-connect-events-asyncapi.yml
  - type: Documentation
    url: https://docs.instacart.com/connect/post-checkout/
  - type: Documentation
    url: https://docs.instacart.com/catalog/catalog_api/overview/
- aid: instacart:instacart-delivery-api
  name: instacart Delivery API
  description: Endpoints for finding delivery stores, previewing time slots, reserving time slots, and creating delivery orders.
  humanURL: https://docs.instacart.com/developer_platform_api/
  baseURL: https://connect.instacart.com
  tags:
  - Delivery
  properties:
  - type: OpenAPI
    url: openapi/instacart-delivery-api-openapi.yml
  - type: Documentation
    url: https://docs.instacart.com/developer_platform_api/
  - type: GraphQL
    url: graphql/instacart-graphql.md
  - type: Documentation
    url: https://docs.instacart.com/connect/fulfillment/
  - type: AsyncAPI
    url: asyncapi/instacart-connect-events-asyncapi.yml
  - type: Documentation
    url: https://docs.instacart.com/connect/post-checkout/
  - type: Documentation
    url: https://docs.instacart.com/catalog/catalog_api/overview/
- aid: instacart:instacart-items-api
  name: instacart Items API
  description: Endpoints for updating item-level attributes such as pricing and availability at specific store locations.
    Items contain information that can vary from one store to another.
  humanURL: https://docs.instacart.com/developer_platform_api/
  baseURL: https://connect.instacart.com
  tags:
  - Items
  properties:
  - type: OpenAPI
    url: openapi/instacart-items-api-openapi.yml
  - type: Documentation
    url: https://docs.instacart.com/developer_platform_api/
  - type: GraphQL
    url: graphql/instacart-graphql.md
  - type: Documentation
    url: https://docs.instacart.com/connect/fulfillment/
  - type: AsyncAPI
    url: asyncapi/instacart-connect-events-asyncapi.yml
  - type: Documentation
    url: https://docs.instacart.com/connect/post-checkout/
  - type: Documentation
    url: https://docs.instacart.com/catalog/catalog_api/overview/
- aid: instacart:instacart-last-mile-delivery-api
  name: instacart Last Mile Delivery API
  description: Endpoints for last mile delivery where items are pre-packed and only require delivery from the store to the
    customer.
  humanURL: https://docs.instacart.com/developer_platform_api/
  baseURL: https://connect.instacart.com
  tags:
  - Last Mile Delivery
  properties:
  - type: OpenAPI
    url: openapi/instacart-last-mile-delivery-api-openapi.yml
  - type: Documentation
    url: https://docs.instacart.com/developer_platform_api/
  - type: GraphQL
    url: graphql/instacart-graphql.md
  - type: Documentation
    url: https://docs.instacart.com/connect/fulfillment/
  - type: AsyncAPI
    url: asyncapi/instacart-connect-events-asyncapi.yml
  - type: Documentation
    url: https://docs.instacart.com/connect/post-checkout/
  - type: Documentation
    url: https://docs.instacart.com/catalog/catalog_api/overview/
- aid: instacart:instacart-orders-api
  name: instacart Orders API
  description: Endpoints for retrieving order status, handling details, and item information after checkout.
  humanURL: https://docs.instacart.com/developer_platform_api/
  baseURL: https://connect.instacart.com
  tags:
  - Orders
  properties:
  - type: OpenAPI
    url: openapi/instacart-orders-api-openapi.yml
  - type: Documentation
    url: https://docs.instacart.com/developer_platform_api/
  - type: GraphQL
    url: graphql/instacart-graphql.md
  - type: Documentation
    url: https://docs.instacart.com/connect/fulfillment/
  - type: AsyncAPI
    url: asyncapi/instacart-connect-events-asyncapi.yml
  - type: Documentation
    url: https://docs.instacart.com/connect/post-checkout/
  - type: Documentation
    url: https://docs.instacart.com/catalog/catalog_api/overview/
- aid: instacart:instacart-pickup-api
  name: instacart Pickup API
  description: Endpoints for finding pickup stores, previewing time slots, reserving time slots, and creating pickup orders.
  humanURL: https://docs.instacart.com/developer_platform_api/
  baseURL: https://connect.instacart.com
  tags:
  - Pickup
  properties:
  - type: OpenAPI
    url: openapi/instacart-pickup-api-openapi.yml
  - type: Documentation
    url: https://docs.instacart.com/developer_platform_api/
  - type: GraphQL
    url: graphql/instacart-graphql.md
  - type: Documentation
    url: https://docs.instacart.com/connect/fulfillment/
  - type: AsyncAPI
    url: asyncapi/instacart-connect-events-asyncapi.yml
  - type: Documentation
    url: https://docs.instacart.com/connect/post-checkout/
  - type: Documentation
    url: https://docs.instacart.com/catalog/catalog_api/overview/
- aid: instacart:instacart-products-api
  name: instacart Products API
  description: Endpoints for creating and updating products in the retailer's catalog on Instacart. Products are the same
    across all of a retailer's stores.
  humanURL: https://docs.instacart.com/developer_platform_api/
  baseURL: https://connect.instacart.com
  tags:
  - Products
  properties:
  - type: OpenAPI
    url: openapi/instacart-products-api-openapi.yml
  - type: Documentation
    url: https://docs.instacart.com/developer_platform_api/
  - type: GraphQL
    url: graphql/instacart-graphql.md
  - type: Documentation
    url: https://docs.instacart.com/connect/fulfillment/
  - type: AsyncAPI
    url: asyncapi/instacart-connect-events-asyncapi.yml
  - type: Documentation
    url: https://docs.instacart.com/connect/post-checkout/
  - type: Documentation
    url: https://docs.instacart.com/catalog/catalog_api/overview/
- aid: instacart:instacart-replacements-api
  name: instacart Replacements API
  description: Endpoints for managing item replacements suggested by shoppers during order fulfillment.
  humanURL: https://docs.instacart.com/developer_platform_api/
  baseURL: https://connect.instacart.com
  tags:
  - Replacements
  properties:
  - type: OpenAPI
    url: openapi/instacart-replacements-api-openapi.yml
  - type: Documentation
    url: https://docs.instacart.com/developer_platform_api/
  - type: GraphQL
    url: graphql/instacart-graphql.md
  - type: Documentation
    url: https://docs.instacart.com/connect/fulfillment/
  - type: AsyncAPI
    url: asyncapi/instacart-connect-events-asyncapi.yml
  - type: Documentation
    url: https://docs.instacart.com/connect/post-checkout/
  - type: Documentation
    url: https://docs.instacart.com/catalog/catalog_api/overview/
common:
- type: AgenticAccess
  url: agentic-access/instacart-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/instacart-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/instacart-domain-security.yml
- type: Authentication
  url: authentication/instacart-authentication.yml
- type: GitHubOrganization
  url: https://github.com/instacart
- type: LinkedIn
  url: https://www.linkedin.com/company/instacart
- type: JSONLD
  url: json-ld/instacart-context.jsonld
- type: JSONSchema
  url: json-schema/instacart-order-schema.json
- type: JSONSchema
  url: json-schema/instacart-product-schema.json
description: Use the public Instacart APIs to add Instacart shopping capabilities to your applications, such as product shopping
  lists and recipe ingredients.