​
接口说明

获取 Amazon 关键词搜索结果，支持同步返回与异步回调。

本页固定使用 parserName=amzKeyword。

​
请求URL

POST https://scrapeapi.pangolinfo.com/api/v1/scrape

​
请求头

参数名参数值类型说明
Content-Typeapplication/jsonstring数据格式
AuthorizationBearer xxxstring认证凭证

​
请求参数

参数必填类型说明
url 条件必填 string 目标网页URL
注：如不填写该参数，则必须同时填写 site 和 content 参数
parserNameYesstring固定值：amzKeyword.
site 条件必填 string 站点信息
注：若已填写 url，则 site 参数可不填
已支持的国家/站点（13 个）：
amz_us（美国）/ amz_de（德国）/ amz_uk（英国）/ amz_jp（日本）/ amz_fr（法国）/ amz_it（意大利）/ amz_es（西班牙）/ amz_ca（加拿大）/ amz_au（澳大利亚）/ amz_mx（墨西哥）/ amz_sa（沙特阿拉伯）/ amz_ae（阿联酋）/ amz_br（巴西）
content条件必填string填写关键词。使用url时可省略；否则与site一起传入。
format Yes string 数据返回格式。可用值：json（结构化数据，默认值，1 积点/次）、rawHtml（原始 HTML，0.75 积点/次）、markdown（Markdown，0.75 积点/次）
bizContext.zipcode No string 可选；传入时按该邮编抓取（所有解析器与输出格式均生效），不传时后端从对应站点的邮编池随机选择。必须与站点国家匹配。关键词、类目、卖家、热卖榜、新品榜、配送时效的响应 data.zipcode 返回本次实际使用的邮编。
美国：10041 / 90001 / 60601 / 84104
英国：W1S 3AS / EH15 1LR / M13 9PL / M2 5BQ
加拿大：M4C 4Y4 / V6E 1N2 / H3G 2K8 / T2R 0G5
德国：80331 / 10115 / 20095 / 60306
法国：75000 / 69001 / 06000 / 13000
日本：100-0004 / 060-8588 / 163-8001 / 900-8570
意大利：20019 / 50121 / 00042 / 30100
西班牙：41001 / 28001 / 08001 / 46001
澳大利亚：2000_SYDNEY / 3000_MELBOURNE
墨西哥：01000 / 55000
沙特阿拉伯：Riyadh_الرياض / Jeddah_جدة
阿联酋：Abu Dhabi_ADCO Compound / Ajman_Aamra
巴西：03001-000 / 20031-000

​
响应值

返回值类型说明
codeint状态码
messagestring信息
dataobject返回数据

​
返回参数 data 说明

返回值类型说明
jsonobject[]返回json数据
urlstring任务URL
taskIdstring任务ID

​
解析结果字段

同步响应的data.json[]包含解析结果；商品记录位于解析结果的data.results[]。

参数类型说明
asinstringASIN码
titlestring商品标题
pricestring商品价格
starstring商品评分
ratingstring商品评分数
imagestring图片链接
salesstring商品销量
rankint自然排名
sponsoredstring是否 SP 广告
spRankintSP 广告排名
badgestring徽章
deliveryobject发货时间

​
请求示例

curl -X POST "https://scrapeapi.pangolinfo.com/api/v1/scrape" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://www.amazon.com/s?k=coffee",
  "parserName": "amzKeyword",
  "format": "json"
}'

​
返回示例

以下为结构示例，字段值用于说明响应格式。

{
  "code": 0,
  "message": "ok",
  "data": {
    "json": [
      {
        "code": 0,
        "message": "ok",
        "data": {
          "results": [
            {
              "asin": "B0B4NLGCH5",
              "title": "Example product",
              "price": "",
              "star": "",
              "rating": "",
              "image": "",
              "sales": "",
              "rank": 0,
              "sponsored": "",
              "spRank": 0,
              "badge": "",
              "delivery": {}
            }
          ]
        }
      }
    ],
    "url": "https://www.amazon.com/s?k=coffee",
    "taskId": "example-task-id",
    "zipcode": "10041"
  }
}

​
异步调用说明

适用于批量任务及无需保持HTTP长连接的场景。在同一请求URL中传入bizContext.callbackUrl（可公网访问的回调地址）启用异步；不传则同步返回。异步format固定为json，邮编参数仍可使用。

参数必填类型说明
bizContext.callbackUrlYesstring客户回调URL，仅异步必填。
curl -X POST "https://scrapeapi.pangolinfo.com/api/v1/scrape" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://www.amazon.com/s?k=coffee",
  "parserName": "amzKeyword",
  "format": "json",
  "bizContext": {
    "callbackUrl": "https://your-domain.com/webhooks/amazon"
  }
}'

​
受理响应

{
  "code": 0,
  "message": "ok",
  "data": {
    "taskId": "example-task-id"
  }
}

​
结果回调

任务完成后向callbackUrl发送JSON POST。回调data直接是解析结果，不是同步响应的data.json数组封装。taskId、pointCost位于回调顶层。接收服务应按taskId幂等处理，并返回HTTP 2xx；投递失败会自动重试。

{
  "code": 0,
  "message": "ok",
  "data": {
    "code": 0,
    "message": "ok",
    "data": {
      "results": [
        {
          "asin": "B0B4NLGCH5",
          "title": "Example product",
          "price": "",
          "star": "",
          "rating": "",
          "image": "",
          "sales": "",
          "rank": 0,
          "sponsored": "",
          "spRank": 0,
          "badge": "",
          "delivery": {}
        }
      ]
    }
  },
  "taskId": "example-task-id",
  "pointCost": 1,
  "zipcode": "10041"
}

​
积点消耗说明

JSON每次成功抓取1积点；rawHtml / markdown每次0.75积点。异步仅支持JSON，最终费用见pointCost。 异步受理时冻结积点，终态结算；未获取内容会退还冻结积点，解析完成后客户回调投递失败不退款。