Catalog / eBay Public Browsing

eBay Public Browsing API

ebay.com

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.

  • shopping
  • eBay
  • marketplace
  • listings
4 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In 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 key

Sign 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.

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.

Free-text query sent to eBay's native search.

Optional parameters 10

1-based eBay result page.

Number of results requested from eBay via _ipg; eBay may return fewer.

Native eBay sort: best_match, ending_soonest, newly_listed, price_shipping_lowest, or price_shipping_highest.

Optional eBay category ID (_sacat).

Optional native condition filters: new, open_box, refurbished, refurbished_good, refurbished_fair, refurbished_seller, used, or for_parts_or_not_working.

Optional native buying-format filters: buy_it_now or auction.

Optional lower item-price bound in the search currency.

Optional upper item-price bound in the search currency.

If true, request eBay's free-shipping filter.

If true, request eBay's free-returns filter.

View call pricing
cURL · Search
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.

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 · string

The numeric eBay item number returned by search.

Example: 406452584458

Response

urlstring
price?object
price.amount?number | null
price.currency?string | null
price.source_text?string | null
price.maximum_amount?number | null
price.minimum_amount?number | null
titlestring
images?string[]
item_idstring
condition?string | null
sold_text?string | null
seller_url?string | null
source_urlstring
variations?object[]
description?string | null
seller_name?string | null
availability?string | null
retrieved_atstring (date-time)
returns_text?string | null
seller_notes?string | null
source_offer?object
location_text?string | null
purchase_mode?string | null
shipping_text?string | null
image_metadata?object[]
image_metadata[].urlstring
image_metadata[].width?string | null
image_metadata[].height?string | null
image_metadata[].description?string | null
item_specifics?object
payment_methods?string[]
availability_text?string | null
related_references?string[]
category_breadcrumbs?object[]
source_date_modified?string | null
seller_followers_text?string | null
seller_items_sold_text?string | null
seller_feedback_percentage?number | null

Fields 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 · string

The eBay store slug from a listing's seller_url. A seller username and store slug can be different source identifiers.

Example: vipshop999

Response

urlstring
name?string | null
usernamestring
categories?string[]
source_urlstring
store_slugstring
description?string | null
retrieved_atstring (date-time)
followers_text?string | null
items_sold_text?string | null
feedback_percentage?number | null

Fields 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 · string

The eBay store slug from a listing's seller_url.

Example: vipshop999

pageOptionalQuery · integer, min: 1, default: 1

1-based seller-store page (_pgn).

Example: 1

page_sizeOptionalQuery · integer, min: 1, max: 240, default: 24

Seller-store items per page (_ipg).

Example: 24

Response

pageinteger
itemsobject[]
items[].urlstring
items[].price?object
items[].price.amount?number | null
items[].price.currency?string | null
items[].price.source_text?string | null
items[].price.maximum_amount?number | null
items[].price.minimum_amount?number | null
items[].titlestring
items[].item_idstring
items[].promoted?boolean | null
items[].condition?string | null
items[].image_url?string | null
items[].sold_text?string | null
items[].offer_type?string | null
items[].seller_url?string | null
items[].seller_name?string | null
items[].source_rank?integer | null
items[].variation_id?string | null
items[].location_text?string | null
items[].shipping_text?string | null
items[].source_positioninteger
items[].leaf_category_id?string | null
items[].seller_feedback_count_text?string | null
items[].seller_feedback_percentage?number | null
next_page?integer | null
page_sizeinteger
seller_refstring
source_urlstring
store_slugstring
result_countinteger
retrieved_atstring (date-time)
previous_page?integer | null

Fields 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.