API Reference
Use Crawlora's Instacart API endpoints to extract supported public Instacart data as structured JSON. This documentation covers 6 active endpoints including Get Instacart store department taxonomy, Get Instacart product detail at a store, Search Instacart product terms near a postal code, Search Instacart product terms at a store, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as shop_id, store_slug, postal_code, retailer_location_id, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/instacart/stores" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/instacart/departmentsapiKey3 credits/requestReturns a store's department/category taxonomy (Produce, Dairy & Eggs, Bakery, ...) two levels deep -- department and subcategory. Metadata only, does not return products. Public data sourced from Instacart's own storefront navigation.
Required params: shop_id:query, store_slug:query, postal_code:query
/instacart/itemapiKey5 credits/requestReturns a single product's detail at a specific Instacart store: name, size, brand, image, current pricing (with any sale/offer badge), availability, stock level, dietary labels, and nutrition facts. Public data sourced from Instacart's own storefront pages.
Required params: shop_id:query, store_slug:query, retailer_location_id:query, product_id:query, postal_code:query
/instacart/search-nearbyapiKey3 credits/requestReturns Instacart's own search-term autosuggestions for a keyword across every retailer serving a postal code at once, rather than one specific store. Public data sourced from Instacart's own cross-retailer search.
Required params: postal_code:query, q:query
/instacart/searchapiKey3 credits/requestReturns Instacart's own search-term autosuggestions for a keyword within one store -- the same suggestion list shown in the site's own search box dropdown. This is term-level (matching search phrases plus a representative thumbnail), not a paginated product-results list. Public data sourced from Instacart's own storefront search.
Required params: shop_id:query, store_slug:query, q:query
/instacart/storesapiKey3 credits/requestFinds Instacart retailer storefronts (grocery stores, warehouse clubs, and other partner retailers) serving a US postal code, each with the identifiers needed to look up its items and search suggestions. Public data sourced from Instacart's own store-discovery API.
Required params: postal_code:query
/instacart/trendingapiKey3 credits/requestReturns Instacart's own popular/trending search terms across every retailer serving a postal code -- the same blank-state suggestions shown before a user types anything into the search box. Public data sourced from Instacart's own cross-retailer search.
Required params: postal_code:query
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| Get Instacart store department taxonomy | /instacart/departments | GET | 3 credits/request | shop_id:query, store_slug:query, postal_code:query | View docs | Try endpoint |
| Get Instacart product detail at a store | /instacart/item | GET | 5 credits/request | shop_id:query, store_slug:query, retailer_location_id:query, product_id:query, postal_code:query | View docs | Try endpoint |
| Search Instacart product terms near a postal code | /instacart/search-nearby | GET | 3 credits/request | postal_code:query, q:query | View docs | Try endpoint |
| Search Instacart product terms at a store | /instacart/search | GET | 3 credits/request | shop_id:query, store_slug:query, q:query | View docs | Try endpoint |
| Find Instacart stores near a postal code | /instacart/stores | GET | 3 credits/request | postal_code:query | View docs | Try endpoint |
| Get Instacart trending search terms near a postal code | /instacart/trending | GET | 3 credits/request | postal_code:query | View docs | Try endpoint |