Free tier · no payment method required

eBay item API

Retrieve listing details by item ID with the eBay item API. Get structured JSON for item research across supported marketplaces through REST or MCP. Use one server-side API key across 3 supported eBay marketplaces.

Get an API key View Documentation

TL;DR

The eBay item API returns structured eBay JSON as a flat JSON object. It is available through REST and MCP, with a 24 hours for ended items; 15 minutes for active items cache policy and explicit request, freshness, rate-limit, and usage metadata.

Use this eBay operation through

REST API OpenAPI MCP and agent Skill

API example

Explore the eBay item API in your browser

Inspect the example request parameters and JSON response before integrating.

Explore the Item details API

Inspect the example request and response before writing a single line.

GET/v1/item/377534750427

ebaySiteebay.com

Example response

{
  "itemId": "377534750427",
  "title": "Example eBay listing",
  "price": "37.00",
  "currency": "USD",
  "ended": true,
  "endedDate": "2026-10-07T22:10:49Z"
}

Endpoint

What does the eBay item API return?

The eBay item details operation is available through every SoldFetch interface and resolves through the same validation and normalized output contract.

REST responseavailable

GET /v1/item/{itemId} returns a flat JSON object.

OpenAPI contractavailable

Inspect the versioned input parameters and response schemas before integrating.

MCP toolavailable

get_ebay_item exposes the allowlisted operation to compatible AI agents.

Developer First

How do you call the eBay item API in seconds?

Use /v1/item/{itemId} to retrieve eBay item details data without maintaining marketplace-specific acquisition, parsers, retry rules, or response adapters.

One schema, every operation

Use this API alongside 2 other SoldFetch operations without changing authentication or the documented JSON format.

Metadata, not guesswork

Every response includes request, cache, freshness, rate-limit, and usage metadata for production decisions.

See the contract before coding

Copy a request in Python, TypeScript, or cURL and inspect the example JSON before moving into production.

import requests

response = requests.get(
    'https://soldfetch.com/v1/item/377534750427',
    params={'ebaySite': 'ebay.com'},
    headers={'API-KEY': 'soldfetch_live_YOUR_API_KEY'}
)
data = response.json()

[ .JSON ]

{
  "itemId": "377534750427",
  "title": "Example eBay listing",
  "price": "37.00",
  "currency": "USD",
  "ended": true,
  "endedDate": "2026-10-07T22:10:49Z"
}

Browse all 3 APIs

One eBay API, 3 marketplaces

How does SoldFetch normalize eBay item details data across marketplaces?

eBay storefronts vary by host, currency, locale, delivery context, and available fields. SoldFetch keeps those differences behind one versioned item details contract.

One schema, every marketplace

One documented contract.

3 eBay storefronts use the same ebaySite hostname parameter, validation layer, and output contract.

ebaySite: ebay.com fetchedAt: ISO timestamp

Currency and locale included

Context stays attached.

Marketplace, currency, delivery context, request ID, cache state, and fetch time travel with the normalized response.

cache: HIT fetched_at: 2026-08-16T12:00:00Z usage_units: 1

REST and MCP

One key, every interface.

Keep one server-side API key while application code and agents use the interface that fits their workflow.

REST: /v1/item/{itemId} MCP: get_ebay_item

Operation-level freshness

Caching fits the data.

Cache duration: 24 hours for ended items; 15 minutes for active items. Retrieval timestamps stay unchanged on cache hits.

maximum_cache_ttl: 86400 rate_limit: documented request_id: soldfetch_...

Get an API key

SoldFetch eBay API3 request examples

View docs

GET/v1/item/377534750427?ebaySite=ebay.com

ebaySiteebay.com

curl 'https://soldfetch.com/v1/item/377534750427?ebaySite=ebay.com' \
  -H 'API-KEY: soldfetch_live_YOUR_API_KEY'

Example response

{
  "itemId": "377534750427",
  "title": "Example eBay listing",
  "price": "37.00",
  "currency": "USD",
  "ended": true,
  "endedDate": "2026-10-07T22:10:49Z"
}

Compare

How does SoldFetch's eBay item API compare to a self-managed integration?

SoldFetch packages eBay item details acquisition, validation, normalization, caching, errors, and request metadata behind one server-side key.

FeatureSoldFetchSelf managed

AuthenticationOne API-KEY headerSource-specific credentials or sessions

Setup requiredCreate a key and call the endpointBuild acquisition, parsing, retries, and adapters

Marketplace support3 stores through one contractSeparate host and locale handling

Response schemaFlat JSONSource-specific page structures

Freshness24 hours for ended items; 15 minutes for active items policy with metadataYour team owns caching and observation time

InterfacesREST, MCP, and SkillYour team maintains each adapter

How is eBay item API usage measured?

Successful normalized operations consume the units defined by the active plan. Request headers make usage and rate-limit state visible to your backend.

Can I use eBay item details data in production?

Use public data, respect source rules and third-party rights, keep keys server-side, and match retention and downstream processing to your approved use case.

FAQ

eBay API questions, answered

Answers about this eBay API, its parameters, interfaces, freshness, and production use.

How do I call the eBay item API?

Create a SoldFetch key, send a GET request to /v1/item/{itemId} with one of the documented identifier or query presets, and read the flat JSON response.

What does the eBay item API return?

Retrieve public eBay item details by item ID. Optional fields remain optional, and every eBay API response includes request and freshness metadata needed for production handling.

Which eBay marketplaces support item details?

Use the same operation across 3 supported eBay marketplaces by passing the documented ebaySite value.

How fresh is eBay item details data?

This operation uses a 24 hours for ended items; 15 minutes for active items cache policy. Read the cache-state and data-fetched-at headers instead of inferring freshness from when your application received the response.

Can I use the eBay item API with an AI agent?

Yes. The get_ebay_item MCP tool and generated documentation expose the same allowlisted eBay operation and validation rules.

Can I use the eBay item API in production?

Yes. Keep keys server-side, validate optional fields, store request IDs, use bounded retries for temporary failures, and review source rules and third-party rights for your use case.

Contract statistics

eBay API contract at a glance

Current eBay item details details generated from SoldFetch's versioned operation catalog.

eBay marketplaces

24 hours for ended items; 15 minutes for active items

cache policy

interfaces

Ready to call the eBay item API?

Create a key, keep it server-side, and run the predefined eBay request in minutes.

Get an API key