eBay listing data. Search by keyword or GTIN, or look up a specific item by ID.
country accepts: au at be ca fr de ie it hk my nl pl sg es ch uk (gb) us
uk and gb are two codes for the same UK marketplace — not a separate locale.
| Key | Values | Description |
|---|---|---|
term | Free text | Keyword search. |
id | eBay item ID (numeric) | Direct item lookup. |
gtin | EAN / GTIN-13 | GTIN search. |
| Topic | Description |
|---|---|
search (default) | Item / listing data. |
| Field | Description |
|---|---|
id | eBay item ID. |
name | Listing title. |
price | Item price. |
currency | ISO currency. |
shipping | Shipping cost. |
total | price + shipping. |
shop_name | Seller name. |
shop_type | Seller type (e.g. marketplace shop vs. standalone shop). |
shop_url | Seller URL. |
shop_review_rating / shop_review_count | Seller review signal. |
A keyword/GTIN search returns price aggregates (price_min / price_avg / price_max), offers_count, and an offers[] list; an item lookup returns the single-listing fields above.
curl -s https://api.kwery.co/job \
-H "Authorization: Bearer $KWERY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"source":"ebay","country":"de","key":"gtin","values":["4006381333962"]}'Results are fetched with GET /job/{id}/download once the job is finished — each entry is the result for one input value (abridged):
[
{
"key": "4006381333962",
"success": true,
"reason": null,
"content": {
"name": "STABILO point 88 fineliner",
"currency": "EUR",
"price_min": 12.49,
"price_avg": 13.99,
"price_max": 15.49,
"offers_count": 2,
"offers": [
{ "id": "1234567890", "shop_name": "office-supplies-de", "shop_type": "marketplace shop", "price": 12.49, "currency": "EUR", "shipping": 2.99, "total": 15.48 },
{ "id": "2345678901", "shop_name": "papershop24", "shop_type": "standalone shop", "price": 15.49, "currency": "EUR", "shipping": 0, "total": 15.49 }
]
}
}
]