Properties
| Name | Type | Description |
|---|---|---|
| request_id | string | ID of this request. Poll it at /v1/jobs/{request_id}. |
| status | string | pending, complete or failed. Always check it, even on HTTP 200. |
| credits | integer | Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed. |
| cached | boolean | True when the result came from the 15-minute cache. |
| poll_url | string | Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL. |
| result | object | |
| error | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/soldgraph-com/json-schema/soldgraph-com-ebay-listings-job-schema.json",
"title": "EbayListingsJob",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/soldgraph-com-ebay-api-openapi.yml#/components/schemas/EbayListingsJob",
"type": "object",
"required": [
"request_id",
"status",
"credits",
"cached"
],
"properties": {
"request_id": {
"type": "string",
"description": "ID of this request. Poll it at /v1/jobs/{request_id}."
},
"status": {
"type": "string",
"description": "pending, complete or failed. Always check it, even on HTTP 200.",
"enum": [
"pending",
"complete",
"failed"
]
},
"credits": {
"type": "integer",
"description": "Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed."
},
"cached": {
"type": "boolean",
"description": "True when the result came from the 15-minute cache."
},
"poll_url": {
"type": "string",
"description": "Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL."
},
"result": {
"$ref": "#/$defs/EbayListingsPage"
},
"error": {
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"enum": [
"page_mismatch",
"schema",
"network",
"upstream",
"throttled",
"blocked",
"rejected",
"not_found",
"filter_not_supported",
"filter_not_applied",
"location_not_served",
"auth",
"daily_limit",
"deadline_exceeded",
"credential_storage"
],
"description": "Failed job code."
},
"message": {
"type": "string",
"description": "What the code means, in plain words."
}
}
}
},
"$defs": {
"EbayListingsPage": {
"type": "object",
"required": [
"provider",
"country",
"query",
"page",
"count",
"reported_total",
"next_page",
"collected_at",
"schema_version",
"completeness",
"field_notes",
"next_cursor",
"page_size",
"summary",
"data"
],
"properties": {
"provider": {
"type": "string",
"description": "Marketplace ID, like ebay or poshmark."
},
"country": {
"type": "string",
"description": "The country searched: us, or on eBay the country you sent."
},
"query": {
"type": "string",
"description": "The q you sent, with extra spaces removed."
},
"page": {
"type": "integer",
"description": "The page you asked for."
},
"count": {
"type": "integer",
"description": "Rows in result.data on this page."
},
"reported_total": {
"type": "integer",
"description": "Total matches the marketplace reports for the search. It may be rounded or capped."
},
"next_page": {
"type": [
"integer",
"null"
],
"description": "Send this as page to get the next page. Null on the last page, and on page 100, the deepest page served."
},
"collected_at": {
"type": "string",
"description": "When we collected the page, as an ISO 8601 timestamp."
},
"schema_version": {
"type": "integer",
"description": "Version of the result's shape for that marketplace: 1 or 2. It only rises when a field changes meaning."
},
"completeness": {
"type": "string",
"description": "provider_page_only: one page as the marketplace served it, not a full history. TCGplayer recent sales say recent_sample_only."
},
"field_notes": {
"type": "string",
"description": "Plain-text notes on how to read this page's fields."
},
"next_cursor": {
"type": "null",
"description": "Always null. eBay pages by number: send page=next_page for the next page."
},
"page_size": {
"type": "integer",
"description": "Rows per page, as eBay reports it."
},
"summary": {
"type": "object",
"properties": {
"priced_count": {
"type": "integer",
"description": "Rows on this page that show one price in the site's currency."
},
"currency": {
"type": "string",
"description": "Currency of the amounts below."
},
"median": {
"type": [
"number",
"null"
],
"description": "Middle displayed price of those rows."
},
"low": {
"type": [
"number",
"null"
],
"description": "Lowest displayed price."
},
"high": {
"type": [
"number",
"null"
],
"description": "Highest displayed price."
},
"p25": {
"type": [
"number",
"null"
],
"description": "First-quartile displayed price: a quarter of priced rows are at or below it."
},
"p75": {
"type": [
"number",
"null"
],
"description": "Third-quartile displayed price. With `p25`, a range that ignores a stray accessory or parts listing."
}
},
"required": [
"priced_count",
"currency",
"median",
"low",
"high",
"p25",
"p75"
],
"description": "Price maths over the rows on this page: priced_count, currency, median, low, high. No row is removed from data. Rows with a price range or an unread price are left out of the maths."
},
"data": {
"type": "array",
"items": {
"$ref": "#/$defs/EbayListingsRow"
}
}
}
},
"EbayListingsRow": {
"type": "object",
"required": [
"id",
"title",
"link",
"promoted",
"format",
"displayed_price",
"displayed_price_text",
"displayed_price_range",
"displayed_shipping",
"shipping_text",
"condition",
"bid_count",
"ends_at",
"best_offer",
"seller_text",
"location_text",
"image"
],
"properties": {
"id": {
"type": "string",
"description": "The marketplace's listing ID."
},
"title": {
"type": [
"string",
"null"
],
"description": "Listing title as shown."
},
"link": {
"type": "string",
"description": "URL of the listing on the eBay site you searched, like https://www.ebay.co.uk/itm/…."
},
"promoted": {
"type": "boolean",
"description": "True for a sponsored placement."
},
"format": {
"type": "string",
"description": "auction when the listing shows bids or an end time, otherwise fixed_price."
},
"displayed_price": {
"oneOf": [
{
"$ref": "#/$defs/Money"
},
{
"type": "null"
}
],
"description": "{ amount, currency } parsed from the price shown: the asking price or current bid. Null if it couldn't be read. Null when eBay shows a price range for a multi-variation listing (\"$247.00 to $911.00\"): the amount wouldn't say which variant. The range is in displayed_price_range and displayed_price_text."
},
"displayed_price_text": {
"type": [
"string",
"null"
],
"description": "The price text as shown, like $189.00, £124.46 or €230.00."
},
"displayed_price_range": {
"type": [
"object",
"null"
],
"required": [
"low",
"high",
"currency"
],
"properties": {
"low": {
"type": "number"
},
"high": {
"type": "number"
},
"currency": {
"type": "string",
"description": "ISO 4217 code, like USD."
}
},
"description": "{ low, high, currency } when eBay shows a price range for a multi-variation listing (\"$247.00 to $911.00\"). Null otherwise. displayed_price is null for these rows, so they stay out of the summary maths."
},
"displayed_shipping": {
"oneOf": [
{
"$ref": "#/$defs/Money"
},
{
"type": "null"
}
],
"description": "{ amount, currency } read from exact shipping text, in the site's currency, like +$9.99 delivery, +£3.92 delivery or +€6.99 Lieferung. Free shipping is 0, in every country's wording. Estimates and Shipping not specified are null."
},
"shipping_text": {
"type": [
"string",
"null"
],
"description": "Shipping text as shown, like +$9.99 delivery, Free delivery or + €10.49 de envío."
},
"condition": {
"type": [
"string",
"null"
],
"description": "eBay's condition text as shown, in the site's language, like Pre-Owned, Pre-owned or Gebraucht. To filter by condition in any language, use condition."
},
"bid_count": {
"type": [
"integer",
"null"
],
"description": "Number of bids, for auctions."
},
"ends_at": {
"type": [
"string",
"null"
],
"description": "Auction end time, ISO 8601 UTC."
},
"best_offer": {
"type": "boolean",
"description": "True when the seller accepts Best Offers."
},
"seller_text": {
"type": [
"string",
"null"
],
"description": "Seller text as eBay shows it: username, feedback count and positive percentage, e.g. clutch_supply (1,325) 99.7%."
},
"location_text": {
"type": [
"string",
"null"
],
"description": "Item location text as shown."
},
"image": {
"type": [
"string",
"null"
],
"description": "Image URL on i.ebayimg.com."
}
}
},
"Money": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number"
},
"currency": {
"type": "string",
"description": "ISO 4217 code, like USD."
}
}
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/soldgraph-com-ebay-listings-job"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.