Just One API Docs
Just Serp APIJust Serp APIGoogle Search API

简体中文

English

简体中文

English

Appearance

亚马逊按类别获取商品 API (V1) ​

GET
/api/amazon/get-category-products/v1
接口健康状态
健康 可用 少量可用 基本不可用 暂无数据
正在加载健康状态…

获取亚马逊按类别商品数据，包括标题、价格和评分，用于基于类别的商品发现，并返回商品信息，如标题、价格和评分。

请求参数 ​

参数名位置类型必填默认值说明
tokenquerystring是-此API服务的鉴权令牌。
categoryIdquerystring是-例如：https://amazon.com/s?node=172282 - 亚马逊类别 ID 为 172282
countryquerystring否US亚马逊产品的国家代码。

可用值：
- US: 美国
- AU: 澳大利亚
- BR: 巴西
- CA: 加拿大
- CN: 中国
- FR: 法国
- DE: 德国
- IN: 印度
- IT: 意大利
- MX: 墨西哥
- NL: 荷兰
- SG: 新加坡
- ES: 西班牙
- TR: 土耳其
- AE: 阿拉伯联合酋长国
- GB: 英国
- JP: 日本
- SA: 沙特阿拉伯
- PL: 波兰
- SE: 瑞典
- BE: 比利时
- EG: 埃及
- ZA: 南非
- IE: 爱尔兰
sortByquerystring否RELEVANCE排序方式。

可用值：
- RELEVANCE: 相关性
- LOWEST_PRICE: 最低价格
- HIGHEST_PRICE: 最高价格
- REVIEWS: 评论
- NEWEST: 最新
- BEST_SELLERS: 畅销品
pagequeryinteger否1用于分页的页码。

代码示例 ​

bash
curl -X GET "https://api.justoneapi.com/api/amazon/get-category-products/v1?token=YOUR_API_KEY&categoryId=VALUE"
text
我想使用 Just One API 提供的“按类别获取商品 (V1)”接口。
接口地址: https://api.justoneapi.com/api/amazon/get-category-products/v1
HTTP 方法: GET
身份验证: 在 URL 后添加查询参数“?token=您的API密钥”。
OpenAPI 定义: https://docs.justoneapi.com/openapi/amazon/products-by-category-v1-zh.json

请求参数说明:
- token (query): 此API服务的鉴权令牌。 (必填)
- categoryId (query): 例如：https://amazon.com/s?node=172282 - 亚马逊类别 ID 为 172282 (必填)
- country (query): 亚马逊产品的国家代码。

可用值：
- `US`: 美国
- `AU`: 澳大利亚
- `BR`: 巴西
- `CA`: 加拿大
- `CN`: 中国
- `FR`: 法国
- `DE`: 德国
- `IN`: 印度
- `IT`: 意大利
- `MX`: 墨西哥
- `NL`: 荷兰
- `SG`: 新加坡
- `ES`: 西班牙
- `TR`: 土耳其
- `AE`: 阿拉伯联合酋长国
- `GB`: 英国
- `JP`: 日本
- `SA`: 沙特阿拉伯
- `PL`: 波兰
- `SE`: 瑞典
- `BE`: 比利时
- `EG`: 埃及
- `ZA`: 南非
- `IE`: 爱尔兰
- sortBy (query): 排序方式。

可用值：
- `RELEVANCE`: 相关性
- `LOWEST_PRICE`: 最低价格
- `HIGHEST_PRICE`: 最高价格
- `REVIEWS`: 评论
- `NEWEST`: 最新
- `BEST_SELLERS`: 畅销品
- page (query): 用于分页的页码。

返回格式: JSON

响应处理与错误码：
1. 需通过返回体中的 "code" 字段判断业务结果（code 为 0 表示成功）。
2. 超时建议：建议将请求超时时间设置为至少 60 秒。
3. 业务码说明：
   - 0: 成功
   - 100: Token 无效或已失效
   - 301: 采集失败，请重试
   - 302: 超出速率限制
   - 303: 超出每日配额
   - 400: 参数错误
   - 500: 内部服务器错误
   - 600: 权限不足
   - 601: 余额不足

请帮我用我擅长的编程语言写一个脚本来调用这个接口，并处理返回结果。
python
import requests

url = "https://api.justoneapi.com/api/amazon/get-category-products/v1?token=YOUR_API_KEY&categoryId=VALUE"
response = requests.get(url)
print(response.json())
js
const response = await fetch("https://api.justoneapi.com/api/amazon/get-category-products/v1?token=YOUR_API_KEY&categoryId=VALUE", {
  method: "GET"
});
const data = await response.json();
console.log(data);
java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.justoneapi.com/api/amazon/get-category-products/v1?token=YOUR_API_KEY&categoryId=VALUE"))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}
go
package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	client := &http.Client{}
	url := "https://api.justoneapi.com/api/amazon/get-category-products/v1?token=YOUR_API_KEY&categoryId=VALUE"
	req, _ := http.NewRequest("GET", url, nil)
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}
php
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.justoneapi.com/api/amazon/get-category-products/v1?token=YOUR_API_KEY&categoryId=VALUE");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
curl_close($ch);
echo $response;

响应结果 ​