Skip to main content
GET
Find supported retailers
Use this endpoint before creating Instacart shopping list, recipe, or product detail links when you need the store-specific routing value.
Instacart shopping list and recipe links use retailerId. Instacart product detail links use the retailer slug in retailer.

Authorizations

X-Incarts-API-Key
string
header
required

Headers

X-Correlation-ID
string

Client-supplied request correlation ID. The API echoes this value when provided.

Required string length: 8 - 128

Query Parameters

provider
enum<string>
required

Retailer provider to search. Only Instacart discovery is available in v1.

Available options:
instacart
query
string

Case-insensitive search over retailer name, slug, or retailer id.

Required string length: 1 - 120
limit
integer
default:50

Maximum number of retailers to return.

Required range: 1 <= x <= 100

Response

Retailers found.

data
object[]
required