Apinoa Docs

Image search

eBay image search — accepted parameters and what comes back.

查看原始 .mdx

本页尚未翻译,以英文显示。代码示例在各语言版本中完全相同。

GET|POST /v1/ebay/image-search

Price $0.002 per call. Always 2 units — twice the price of a search. List price; the rate steps down above 1,000 calls a day.

ParameterTypeRequiredNotes
imageobjectyesThe picture to search by: {contentType, data} with data base64-encoded. POST only — a base64 image is tens of kilobytes and a URL caps out around 8 KB.
pageinteger1-based page number. eBay pages by number, so there is no cursor.
pageSizeintegerResults per page: 60, 120 or 240 only, the three page sizes eBay offers. Larger pages take longer to return (about 5 s for 240 items), but a page of any size costs one call.
regionstringBuyer country as ISO 3166-1 alpha-2; sets availability, shipping and price.
curl -X POST https://gateway.apinoa.com/v1/ebay/image-search \
  -H "content-type: application/json" -H "x-api-key: YOUR_API_KEY" \
  -d '{"image": {"contentType": "image/jpeg", "data": "<base64>"}}'

POST only — a base64 image is tens of kilobytes and a URL caps out around 8 KB.

No query. eBay image search has no text refinement, so a query is not accepted. (Shopify's image-search does refine by text.)