Shopping — entry 005 of 15
eBay
eBay's REST platform — Browse, Sell, and related APIs — requires an OAuth2 client-credentials or authorization-code token, confirmed live by a standard invalid_client error from its token endpoint, and is built for server-side integration rather than in-browser calls. New developer accounts get a free daily call allowance with no published paid tier, and higher volume comes from an approval process rather than a fee.
GreatAPIs Score
Embed this badge
<a href="https://greatapis.com/api/ebay/"><img src="https://greatapis.com/badge/ebay.svg" alt="Scored 83 on greatapis.com"></a>Auth quickstart
- Register an app / run the OAuth flow to obtain a bearer token.
- Send it as an Authorization header
Authorization: Bearer <token>
Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.
Endpoints
item5
GET/item/
| Name | In | Required | Type |
|---|---|---|---|
item_ids | query | no | string |
item_group_ids | query | no | string |
| Status | Description | Schema |
|---|---|---|
200 | Success | Items |
400 | Bad Request | — |
404 | Not Found | — |
409 | Conflict | — |
500 | Internal Server Error | — |
GET/item/get_item_by_legacy_id
| Name | In | Required | Type |
|---|---|---|---|
fieldgroups | query | no | string |
legacy_item_id | query | yes | string |
legacy_variation_id | query | no | string |
legacy_variation_sku | query | no | string |
| Status | Description | Schema |
|---|---|---|
200 | OK | Item |
400 | Bad Request | — |
404 | Not Found | — |
409 | Conflict | — |
500 | Internal Server Error | — |
GET/item/get_items_by_item_group
| Name | In | Required | Type |
|---|---|---|---|
item_group_id | query | yes | string |
| Status | Description | Schema |
|---|---|---|
200 | OK | ItemGroup |
400 | Bad Request | — |
404 | Not Found | — |
409 | Conflict | — |
500 | Internal Server Error | — |
GET/item/{item_id}
| Name | In | Required | Type |
|---|---|---|---|
fieldgroups | query | no | string |
item_id | path | yes | string |
| Status | Description | Schema |
|---|---|---|
200 | Success | Item |
400 | Bad Request | — |
404 | Not Found | — |
409 | Conflict | — |
500 | Internal Server Error | — |
POST/item/{item_id}/check_compatibility
| Name | In | Required | Type |
|---|---|---|---|
item_id | path | yes | string |
X-EBAY-C-MARKETPLACE-ID | header | yes | string |
application/json — CompatibilityPayload
| Status | Description | Schema |
|---|---|---|
200 | OK | CompatibilityResponse |
400 | Bad Request | — |
404 | Not Found | — |
409 | Conflict | — |
500 | Internal Server Error | — |
item_summary1
GET/item_summary/search
| Name | In | Required | Type |
|---|---|---|---|
aspect_filter | query | no | string |
auto_correct | query | no | string |
category_ids | query | no | string |
charity_ids | query | no | string |
compatibility_filter | query | no | string |
epid | query | no | string |
fieldgroups | query | no | string |
filter | query | no | string |
gtin | query | no | string |
limit | query | no | string |
offset | query | no | string |
q | query | no | string |
sort | query | no | string |
| Status | Description | Schema |
|---|---|---|
200 | OK | SearchPagedCollection |
400 | Bad Request | — |
409 | Conflict | — |
500 | Internal Server Error | — |
search_by_image1
POST/item_summary/search_by_image
| Name | In | Required | Type |
|---|---|---|---|
aspect_filter | query | no | string |
category_ids | query | no | string |
charity_ids | query | no | string |
fieldgroups | query | no | string |
filter | query | no | string |
limit | query | no | string |
offset | query | no | string |
sort | query | no | string |
application/json — SearchByImageRequest
| Status | Description | Schema |
|---|---|---|
200 | OK | SearchPagedCollection |
400 | Bad Request | — |
409 | Conflict | — |
500 | Internal Server Error | — |
shopping_cart4
GET/shopping_cart/
| Status | Description | Schema |
|---|---|---|
200 | OK | RemoteShopcartResponse |
204 | No Content | — |
400 | Bad Request | — |
403 | Forbidden | — |
404 | Not Found | — |
500 | Internal Server Error | — |
POST/shopping_cart/add_item
application/json — AddCartItemInput
| Status | Description | Schema |
|---|---|---|
200 | OK | RemoteShopcartResponse |
204 | No Content | — |
400 | Bad Request | — |
403 | Insufficient permissions to fulfill the request | — |
409 | Conflict | — |
500 | Internal Server Error | — |
POST/shopping_cart/remove_item
application/json — RemoveCartItemInput
| Status | Description | Schema |
|---|---|---|
200 | OK | RemoteShopcartResponse |
204 | No Content | — |
400 | Bad Request | — |
403 | Insufficient permissions to fulfill the request | — |
409 | Conflict | — |
500 | Internal Server Error | — |
POST/shopping_cart/update_quantity
application/json — UpdateCartItemInput
| Status | Description | Schema |
|---|---|---|
200 | OK | RemoteShopcartResponse |
400 | Bad Request | — |
403 | Insufficient permissions to fulfill the request | — |
409 | Conflict | — |
500 | Internal Server Error | — |
Try it
Developer reference
https://api.ebay.com/buy/browse/v15,000 API calls per day for the default (non-Growth-Check) application tier, confirmed against eBay's own published API Call Limits table (the Browse API's per-app daily allotment, distinct from the higher 10,000/day given to its Feed API); a live unauthenticated GET returns a standard OAuth invalid_token error rather than rate-limit headers, so this couldn't be re-confirmed via response headers the way a keyless API can -- apps close to the ceiling can request a higher limit via eBay's Compatible Application Check / Application Growth Check process.
- GET/item_summary/search
- GET/item/{item_id}
- GET/item/get_item_by_legacy_id
- GET/item/get_items_by_item_group
- GET/shopping_cart/