eBay Public Browsing API
Read-only access to public eBay search results, listing details, seller profiles, and seller listings. Search uses eBay's native query, sort, filter, and page URL parameters; each additional detail or seller listing read is caller-invoked. When eBay returns an anonymous anti-bot challenge, the bounded retry policy closes the prior HTTP session and starts each retry with a fresh cookie jar and connection pool; unresolved refusals remain typed retryable errors.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.
Then ask your agent to use the eBay Public Browsing API for your task.
Call it over HTTP
Get an API keySign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/573ece32-453b-4c06-be86-fd5d0ec96025/api/search' \
--header "Authorization: Bearer $AGENT_DATA_API_KEY" \
--data-urlencode 'query=wireless headphones'Endpoints
Inputs and response fields for every endpoint in this API.
GETSearch/api/search
Retrieve one live page of eBay listing cards. Search does not fetch item details for each result. A challenge retry starts a new anonymous HTTP session before the requested page is retried.
Input
queryRequiredQuery · stringFree-text query sent to eBay's native search.
Example: wireless headphones
pageOptionalQuery · integer, min: 1, default: 11-based eBay result page.
Example: 1
page_sizeOptionalQuery · integer, min: 1, max: 240, default: 24Number of results requested from eBay via _ipg; eBay may return fewer.
Example: 24
sortOptionalQuery · string, default: best_matchNative eBay sort: best_match, ending_soonest, newly_listed, price_shipping_lowest, or price_shipping_highest.
Example: best_match
category_idOptionalQuery · string | nullOptional eBay category ID (_sacat).
Example: 112529
conditionOptionalQuery · array | nullOptional native condition filters: new, open_box, refurbished, refurbished_good, refurbished_fair, refurbished_seller, used, or for_parts_or_not_working.
Example: new
buying_formatOptionalQuery · array | nullOptional native buying-format filters: buy_it_now or auction.
Example: buy_it_now
min_priceOptionalQuery · number, min: 0 | nullOptional lower item-price bound in the search currency.
Example: 10
max_priceOptionalQuery · number, min: 0 | nullOptional upper item-price bound in the search currency.
Example: 100
free_shippingOptionalQuery · boolean | nullIf true, request eBay's free-shipping filter.
Example: true
free_returnsOptionalQuery · boolean | nullIf true, request eBay's free-returns filter.
Example: true
Response
pageintegersortstringitemsobject[]items[].urlstringitems[].price?objectitems[].price.amount?number | nullitems[].price.currency?string | nullitems[].price.source_text?string | nullitems[].price.maximum_amount?number | nullitems[].price.minimum_amount?number | nullitems[].titlestringitems[].item_idstringitems[].promoted?boolean | nullitems[].condition?string | nullitems[].image_url?string | nullitems[].sold_text?string | nullitems[].offer_type?string | nullitems[].seller_url?string | nullitems[].seller_name?string | nullitems[].source_rank?integer | nullitems[].variation_id?string | nullitems[].location_text?string | nullitems[].shipping_text?string | nullitems[].source_positionintegeritems[].leaf_category_id?string | nullitems[].seller_feedback_count_text?string | nullitems[].seller_feedback_percentage?number | nullquerystringfilters?objectnext_page?integer | nullpage_sizeintegersource_urlstringresult_countintegerretrieved_atstring (date-time)previous_page?integer | nullsource_total_text?string | nullFields marked ? are optional.
GETItems by item id/api/items/{item_id}
Retrieve one live public eBay listing and its source-provided related detail. Challenge retries discard the prior anonymous HTTP session and use fresh cookies and a new connection pool.
Input
item_idRequiredPath · stringThe numeric eBay item number returned by search.
Example: 406452584458
Response
urlstringprice?objectprice.amount?number | nullprice.currency?string | nullprice.source_text?string | nullprice.maximum_amount?number | nullprice.minimum_amount?number | nulltitlestringimages?string[]item_idstringcondition?string | nullsold_text?string | nullseller_url?string | nullsource_urlstringvariations?object[]description?string | nullseller_name?string | nullavailability?string | nullretrieved_atstring (date-time)returns_text?string | nullseller_notes?string | nullsource_offer?objectlocation_text?string | nullpurchase_mode?string | nullshipping_text?string | nullimage_metadata?object[]image_metadata[].urlstringimage_metadata[].width?string | nullimage_metadata[].height?string | nullimage_metadata[].description?string | nullitem_specifics?objectpayment_methods?string[]availability_text?string | nullrelated_references?string[]category_breadcrumbs?object[]source_date_modified?string | nullseller_followers_text?string | nullseller_items_sold_text?string | nullseller_feedback_percentage?number | nullFields marked ? are optional.
GETSellers by seller ref/api/sellers/{seller_ref}
Retrieve one live public eBay store profile. The seller reference is a caller-supplied store slug. Challenge retries use a new anonymous HTTP session, cookie jar, and connection pool.
Input
seller_refRequiredPath · stringThe eBay store slug from a listing's seller_url. A seller username and store slug can be different source identifiers.
Example: vipshop999
Response
urlstringname?string | nullusernamestringcategories?string[]source_urlstringstore_slugstringdescription?string | nullretrieved_atstring (date-time)followers_text?string | nullitems_sold_text?string | nullfeedback_percentage?number | nullFields marked ? are optional.
GETSellers by seller ref listings/api/sellers/{seller_ref}/listings
Retrieve one live page of listing cards from a public eBay store. Challenge retries close the previous anonymous HTTP session before creating a fresh session for the next page attempt.
Input
seller_refRequiredPath · stringThe eBay store slug from a listing's seller_url.
Example: vipshop999
pageOptionalQuery · integer, min: 1, default: 11-based seller-store page (_pgn).
Example: 1
page_sizeOptionalQuery · integer, min: 1, max: 240, default: 24Seller-store items per page (_ipg).
Example: 24
Response
pageintegeritemsobject[]items[].urlstringitems[].price?objectitems[].price.amount?number | nullitems[].price.currency?string | nullitems[].price.source_text?string | nullitems[].price.maximum_amount?number | nullitems[].price.minimum_amount?number | nullitems[].titlestringitems[].item_idstringitems[].promoted?boolean | nullitems[].condition?string | nullitems[].image_url?string | nullitems[].sold_text?string | nullitems[].offer_type?string | nullitems[].seller_url?string | nullitems[].seller_name?string | nullitems[].source_rank?integer | nullitems[].variation_id?string | nullitems[].location_text?string | nullitems[].shipping_text?string | nullitems[].source_positionintegeritems[].leaf_category_id?string | nullitems[].seller_feedback_count_text?string | nullitems[].seller_feedback_percentage?number | nullnext_page?integer | nullpage_sizeintegerseller_refstringsource_urlstringstore_slugstringresult_countintegerretrieved_atstring (date-time)previous_page?integer | nullFields marked ? are optional.
Don’t see the endpoint you need?
Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.
An account is required to submit an extension. Prepare your request, then sign in to build.