검색
상품을 검색하거나 붙여넣은 마켓플레이스 링크를 확인하세요.
GET /api/v1/search에는 Bearer 토큰이 필요합니다. 고객 또는 방문 기록을 쓰지 않고 웹사이트 및 앱과 동일한 검색 판단을 사용합니다.
curl --get https://www.ninjabuy.com/api/v1/search \
-H "Authorization: Bearer $NINJABUY_ACCESS_TOKEN" \
--data-urlencode "q=hoodie" \
--data-urlencode "provider=taobao" \
--data-urlencode "page=0"쿼리 매개변수
| 매개변수 | 규칙 |
|---|---|
q | 필수이며 앞뒤 공백을 제거합니다. 키워드: 2~120자. 붙여넣은 링크: 최대 2,048자. |
provider | taobao(기본값) 또는 a1688. |
page | 0부터 시작하는 0~20의 정수이며 기본값은 0입니다. |
각 매개변수를 한 번씩 보내세요. 유효하지 않거나 중복된 매개변수는 bad-body 문제를 포함한 400을 반환합니다.
응답 종류
모든 성공 응답에는 kind와 request_id가 있습니다.
kind | 필드 및 의미 |
|---|---|
products | 키워드 결과: items, page, pageSize, totalCount, maximumPageCount, unread(읽지 못한 붙여넣기의 host 객체이며 그 외에는 null). |
product | 상품 하나: handle과 웹사이트 url. 붙여넣은 링크나 상품 ID 검색은 바로 이 종류로 확인될 수 있습니다. |
vendor | 확인된 상점: vendor. |
sheet | 인식된 Google Sheet: sheetId와 null일 수 있는 gid. 시트 내용은 포함하지 않습니다. |
unsupported | 인식된 미지원 링크: marketplace와 id가 포함된 link. |
products의 각 항목에는 handle, 웹사이트 url, title, price: { amount, currency: "CNY" }, null일 수 있는 image, marketplace(taobao 또는 a1688)가 있습니다. amount는 웹사이트 상품 그리드와 동일한 중국 위안화 단위의 십진수 문자열입니다. 검색 URL은 일반 상품 URL입니다. 추천 실적이 기록되는 링크는 링크로 생성하세요.
사용량 및 요청 제한
붙여넣은 링크는 익명 분석기를 사용하며 유료 Bright Data 차단 해제 서비스를 구매할 수 없습니다. 인식된 상품, 상점, 시트, 미지원 링크는 키워드 검색을 건너뜁니다. 읽지 못한 붙여넣기는 키워드 검색으로 이어져 OT 검색 할당량을 사용할 수 있습니다.
키워드 검색에는 링크 생성 호출과 별도로 계정마다 60초당 30회의 자체 제한이 있습니다. 키워드 검색 허용 단계에 도달한 성공 응답과 검색 제한으로 거부된 응답에는 다음 헤더가 포함됩니다.
RateLimit-Policy: "search";q=30;w=60
RateLimit: "search";r=29;t=60거부된 요청은 429, search-rate-limited 문제, 초 단위 Retry-After를 반환합니다. 확인된 붙여넣기는 두 구간 모두 사용하지 않으며 검색 제한 헤더도 포함하지 않습니다. 모든 응답에는 X-Request-Id와 Cache-Control: no-store가 있습니다. 헤더 필드는 요청 제한을 확인하세요.