Instacart Scraper API

Scrape Instacart product data as structured JSON — search across retailers, pull any storefront, or fetch full product detail with price, size, brand, image, and availability.

原始信息汇总

Instacart Scraper API 数据集详情

概述 这是一个用于实时抓取 Instacart 数据的 API，返回结构化的 JSON 格式数据。支持跨零售商商品搜索、拉取指定零售商的店面信息，或获取单个商品的详细信息（包含价格、品牌、规格、图片、库存状态、类别及饮食属性）。适用于杂货价格追踪、价格比较、商品目录研究和电商市场分析。无需配置 Instacart 登录或抓取环境。

应用场景

• 杂货价格追踪
• 价格比较
• 商品目录研究
• 电商市场分析

主要特性

• 快速：直接返回结构化 JSON，无需自行解析 HTML。
• 跨零售商搜索：一次查询即可获取多个零售商中的匹配商品。
• 商店页面：通过零售商标识符（如 costco、safeway、target）拉取其特色商品。
• 丰富的商品数据：包含价格、原价/促销价、品牌、规格、图片、库存状态、类别、饮食属性。
• 自愈性：能适应上游数据变化，运行于 Apify 平台。

端点列表

方法	端点	描述
GET	/search	跨零售商关键词搜索，返回一页标准化商品。
GET	/storefront	获取单个零售商店面的特色商品。
GET	/detail	根据商品 ID 获取完整的标准化商品对象。

端点参数说明

GET /search

参数	类型	必填	默认值	描述
q	string	是	-	自由文本商品查询，例如 nike 或 milk。
postalCode	string	否	94105	用作位置上下文的美国邮政编码。
maxItems	integer	否	全部	限制返回商品数量（0 表示全部）。

GET /storefront

参数	类型	必填	默认值	描述
retailerSlug	string	是	-	从 URL 中获取的零售商标识符，例如 costco、safeway。
postalCode	string	否	94105	用作位置上下文的美国邮政编码。
maxItems	integer	否	全部	限制返回商品数量（0 表示全部）。

GET /detail

参数	类型	必填	默认值	描述
productId	string	是	-	Instacart 的数字商品 ID（位于 /products/{id} 中的数字部分）。
retailerSlug	string	否	-	用于定价的零售商标识符，例如 safeway。
postalCode	string	否	94105	用作位置上下文的美国邮政编码。

认证方式 通过 RapidAPI 进行认证。每次请求需在请求头中包含：

• X-RapidAPI-Key: YOUR_RAPIDAPI_KEY
• X-RapidAPI-Host: instacart-scraper-api.p.rapidapi.com

响应字段说明（每个商品项）

字段	类型	描述
id	string	Instacart 内部商品项 ID。
productId	string	数字商品 ID（用于 /detail 端点）。
retailerSlug	string / null	零售商标识符（在店面/详情中已知时返回）。
retailerId	string / null	零售商 ID（搜索结果中返回）。
shopId	string / null	商店 ID（搜索结果中返回）。
url	string	商品规范 URL。
name	string	商品名称。
brand	string / null	品牌名称。
size	string / null	包装规格（例如 128 fl oz、each）。
image	string / null	商品图片 URL。
category	string / null	类别（详情端点返回）。
description	string / null	商品描述（详情端点返回）。
price	number / null	当前价格（美元）。
priceString	string / null	格式化的当前价格，例如 $7.99。
fullPriceString	string / null	促销时的原价/全价，例如 $11.82。
priceCurrency	string	货币代码（USD）。
availability	string / null	库存状态，例如 inStock、OutOfStock。
dietaryAttributes	array	饮食标签（例如 Organic、Gluten-Free），有则返回。
source	string	数据来源（search、storefront 或 pdp）。
postalCode	string	用作位置上下文的邮政编码。
scrapedAt	string	抓取时间的 ISO 8601 时间戳。

错误处理 错误返回 JSON 格式及 HTTP 状态码：

• 502：scrape_failed — 缺少必要参数或上游请求失败，建议重试。

常见问题（FAQ）

• 数据新鲜度：每次调用实时抓取 Instacart，反映当前目录和定价。
• 价格因邮政编码而异：Instacart 的价格和库存因位置不同而变化，通过 postalCode 记录位置上下文，默认值为 94105（旧金山）。
• 跨零售商比较商品：使用 /search?q=... 端点，一次响应即可获取多个零售商中的匹配商品。
• 端点区别：/search 返回多个零售商的多个商品，/storefront 返回单个零售商的特色商品，/detail 返回单个商品的完整对象（包含类别、描述）。
• 速率限制：不同订阅计划有各自的速率限制和月配额。