The completed-listings endpoint returns sold items — the closing prices buyers
actually paid, with the date each item sold. Every result has sold set to true
on the response envelope. This is the data resellers, flippers and pricing tools
rely on, since asking prices alone don’t reflect what items actually sell for.Search by keywords, by seller, or both. With seller and no query you get
everything that seller sold.
Only this seller’s sold listings, by eBay username (e.g. musicmagpie). Works
on its own, with no keyword, and combines with query and every other filter.
Page number for paginated results. Range: 1 - 100.Use pagination.has_more to know when to stop — eBay re-serves its last
page if you ask past the end, so this API returns an empty page there.
Results per page. Clamped to one of 60, 120, or 240. eBay puts at most
200 sold listings on a page, so 240 returns 200 and pagination.per_page
says 200; pagination.returned says how many this page holds.
Item condition filter (new, open_box, refurbished, used, for_parts).Trading cards also accept graded and ungraded — eBay’s card conditions for
slabbed (PSA / BGS / CGC) versus raw cards. Pricing a raw card against sales
that include slabs skews the average badly, so price the two separately.
Only items located in this marketplace’s own country (domain=fr → France only)
worldwide
Items from every country
Omit it and you get eBay’s default, which mixes foreign listings into a national
marketplace. Two things follow from that, and both matter for price research:
a national price series picks up sales that never happened in that country, and
a foreign listing’s price is shown converted into the marketplace’s currency
rather than the amount it actually sold for. location=domestic removes both.Any other value returns 400 invalid_location — it is never silently ignored.
ISO date of eBay’s “Sold” label, e.g. 2026-08-19: a day the item sold, on the marketplace’s calendar. On a multi-quantity listing eBay labels an earlier sale, months before ended_at at times. On non-English marketplaces it is the day ended_at falls on in Europe/Berlin.
When eBay last closed this listing out, in UTC to the minute, e.g. 2026-08-19T14:31:00Z: the listing’s end, or the latest sale on a multi-quantity listing that is still live. Results are ordered by it, newest first.
Always null. eBay renders its “Sponsored” badge into every card as anti-scraping bait, so promoted placements cannot be distinguished from organic results.
Pagination metadata with current_page, per_page, total_results, has_more.total_results is populated (the sold results page carries a match count). total_pages may be null — page with has_more rather than a fixed page total.
Every result is one of that seller’s sales, and seller_name says so. Add
query, category_id, condition or a price range to narrow it down. eBay
handles the request; no eBay account or cookies are needed on your side. How
far back it reaches is eBay’s own sold history for that marketplace.
has_more is the stop signal for bulk extraction. Increment page while it is true:
page, all_sold = 1, []while True: r = requests.get( "https://scrapebadger.com/v1/ebay/completed", params={"query": "iphone 13", "per_page": 200, "page": page}, headers={"X-API-Key": API_KEY}, ).json() all_sold += r["results"] if not r["results"] or not r["pagination"]["has_more"]: break page += 1
Do not loop on “until the response is empty” alone. Past its last page eBay
clamps — asking for page 200 of a 133-page result set re-serves page 133.
This API detects that and returns an empty page with has_more: false, but a
client that ignores has_more and retries forever will keep spending credits.
Pages stop at 100, so one search returns at most 20,000 listings at per_page=200; narrow a bigger result set with condition, category_id or a price range (min_price / max_price).
Use the largest per_page you can: each request costs 8 credits regardless of page
size, so per_page=200 is about 3x cheaper per listing than the default.
Results come newest ended_at first, so one day of a seller’s sales is a run of
consecutive pages. To collect a calendar day in your timezone:
Convert the day’s start and end to UTC (for Europe/London on 1 November,
2026-11-01T00:00:00Z to 2026-11-02T00:00:00Z).
Walk seller=<username>&per_page=200&page=1,2,…, keeping results whose
ended_at falls inside that window.
Stop at the first page whose last result has ended_at before the
window’s start.
De-duplicate on item_id.
Things to know before you rely on the count:
One result per listing, not per sale. A multi-quantity listing that sold
several units appears once, at its latest sale. If it sells again after your
day, it moves to that later time, so walk soon after the day ends.
eBay’s sold index is not perfectly consistent. The same page can come back
slightly different from one call to the next (one seller’s page 1 came back in
three versions, 217 listings between them, 200 each). A second walk later can
return a few listings the first missed. Merge walks on item_id.
The sold history is eBay’s. It covers roughly the last 90 days.
A walk of N pages costs 8 × N credits. Your API key’s per-minute limit counts
every /v1 call, so space a long walk out; a 429 carries a Retry-After
header with the seconds to wait.
Each completed/sold request costs 8 credits. Failed requests are not charged.
Sort order. On sold listings eBay applies only the price sorts; best_match, ending_soonest and newly_listed all return the default order, newest ended_at first.
Item condition. graded / ungraded are eBay's trading-card conditions — slabbed (PSA/BGS/CGC) vs raw — so a card can be priced separately from its slabs.
Item location. domestic returns only items located in this marketplace's own country (domain=fr → France only); worldwide widens to every country. Foreign listings are priced in the marketplace's currency after eBay CONVERTS them, so domestic is also how you get untouched native sale prices.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"ScrapeBadger","colors":{"primary":"#16A34A","light":"#22C55E","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/scrapebadger/gnGR4eL2rEJ4E7w3/logo/light.png?fit=max\u0026auto=format\u0026n=gnGR4eL2rEJ4E7w3\u0026q=85\u0026s=d393e30b48870f8495f788d1fad76ad3","dark":"https://mintcdn.com/scrapebadger/pHswKIBb9VFWmUQY/logo/dark.png?fit=max\u0026auto=format\u0026n=pHswKIBb9VFWmUQY\u0026q=85\u0026s=a5c2b0f2229bc45c6de7fb33b2318941"},"favicon":"https://mintcdn.com/scrapebadger/q5UXhzQrMbsIglQS/favicon.png?fit=max\u0026auto=format\u0026n=q5UXhzQrMbsIglQS\u0026q=85\u0026s=cf0ec94b52375fd84ae198f26e812030","api":{"playground":{}},"navbar":{"links":[{"href":"mailto:support@scrapebadger.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://scrapebadger.com/dashboard?utm_source=docs\u0026utm_medium=referral"}},"footer":{"socials":{"x":"https://x.com/scrapebadger","github":"https://github.com/scrape-badger"}},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"gauge","href":"https://scrapebadger.com/dashboard?utm_source=docs\u0026utm_medium=referral"},{"anchor":"Pricing","icon":"credit-card","href":"https://scrapebadger.com/pricing"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"scrapebadger","hasAudioNarration":false,"actualSubdomain":"scrapebadger","customDomains":["docs.scrapebadger.com"],"gitSource":{"type":"github","owner":"scrape-badger","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aeb5b9eb21018c2553e8993","collectionId":"2eeae0da-0a70-4753-8538-b7f5c37441bb","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aeb5b9eb21018c2553e8993"},"entitlements":{},"buildId":"6aeb5b9eb21018c2553e8993","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"Search","count":71},{"language":"default","tag":"Twitter","count":61},{"language":"default","tag":"Naver","count":56},{"language":"default","tag":"Google","count":50},{"language":"default","tag":"Endpoints","count":39},{"language":"default","tag":"Overview","count":38},{"language":"default","tag":"Reference","count":38},{"language":"default","tag":"TikTok","count":36},{"language":"default","tag":"Users","count":29},{"language":"default","tag":"Getting Started","count":22}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".nav-tabs{min-width:0;overflow-x:auto;overscroll-behavior-x:contain;scrollbar-width:thin}.nav-tabs-item{flex-shrink:0;white-space:nowrap}"}],"page":{"pagePath":"api-reference/endpoint/ebay/completed","slug":"/api-reference/endpoint/ebay/completed","pageMetadata":{"title":"Completed / Sold Listings","openapi":"GET /v1/ebay/completed","description":"Search eBay completed (sold) listings — the closing prices buyers actually paid.","href":"/api-reference/endpoint/ebay/completed"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Search eBay completed (sold) listings — the closing prices buyers actually paid.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,Note,ParamField,ResponseField,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The completed-listings endpoint returns `,_jsx(_components.strong,{children:`sold`}),` items — the closing prices buyers\nactually paid, with the date each item sold. Every result has `,_jsx(_components.code,{children:`sold`}),` set to `,_jsx(_components.code,{children:`true`}),`\non the response envelope. This is the data resellers, flippers and pricing tools\nrely on, since asking prices alone don’t reflect what items actually sell for.`]}),`\n`,_jsxs(_components.p,{children:[`Search by keywords, by seller, or both. With `,_jsx(_components.code,{children:`seller`}),` and no `,_jsx(_components.code,{children:`query`}),` you get\neverything that seller sold.`]}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsx(ParamField,{query:`query`,type:`string`,id:`param-query`,children:_jsxs(_components.p,{children:[`Search keywords. Matches against listing titles. Optional when `,_jsx(_components.code,{children:`seller`}),` is\nset; send at least one of the two.`]})}),`\n`,_jsx(ParamField,{query:`seller`,type:`string`,id:`param-seller`,children:_jsxs(_components.p,{children:[`Only this seller’s sold listings, by eBay username (e.g. `,_jsx(_components.code,{children:`musicmagpie`}),`). Works\non its own, with no keyword, and combines with `,_jsx(_components.code,{children:`query`}),` and every other filter.`]})}),`\n`,_jsxs(ParamField,{query:`domain`,type:`string`,default:`com`,id:`param-domain`,children:[_jsxs(_components.p,{children:[`eBay marketplace domain TLD or alias. See `,_jsx(_components.a,{href:`/api-reference/endpoint/ebay/list-markets`,children:_jsx(_components.code,{children:`/v1/ebay/markets`})}),` for all supported values.`]}),_jsxs(_components.p,{children:[`Examples: `,_jsx(_components.code,{children:`com`}),`, `,_jsx(_components.code,{children:`co.uk`}),`, `,_jsx(_components.code,{children:`de`}),`, `,_jsx(_components.code,{children:`fr`}),`, `,_jsx(_components.code,{children:`com.au`})]})]}),`\n`,_jsx(ParamField,{query:`category_id`,type:`string`,id:`param-category-id`,children:_jsxs(_components.p,{children:[`Restrict results to an eBay category id. Use `,_jsx(_components.a,{href:`/api-reference/endpoint/ebay/list-categories`,children:_jsx(_components.code,{children:`/v1/ebay/categories`})}),` to look up ids.`]})}),`\n`,_jsxs(ParamField,{query:`page`,type:`integer`,default:1,id:`param-page`,children:[_jsxs(_components.p,{children:[`Page number for paginated results. Range: `,_jsx(_components.code,{children:`1`}),` - `,_jsx(_components.code,{children:`100`}),`.`]}),_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`pagination.has_more`}),` to know when to stop — eBay re-serves its last\npage if you ask past the end, so this API returns an empty page there.`]})]}),`\n`,_jsx(ParamField,{query:`per_page`,type:`integer`,id:`param-per-page`,children:_jsxs(_components.p,{children:[`Results per page. Clamped to one of `,_jsx(_components.code,{children:`60`}),`, `,_jsx(_components.code,{children:`120`}),`, or `,_jsx(_components.code,{children:`240`}),`. eBay puts at most\n200 sold listings on a page, so `,_jsx(_components.code,{children:`240`}),` returns 200 and `,_jsx(_components.code,{children:`pagination.per_page`}),`\nsays `,_jsx(_components.code,{children:`200`}),`; `,_jsx(_components.code,{children:`pagination.returned`}),` says how many this page holds.`]})}),`\n`,_jsxs(ParamField,{query:`sort_by`,type:`string`,default:`best_match`,id:`param-sort-by`,children:[_jsx(_components.p,{children:`Sort order for results. On sold listings eBay applies only the price sorts.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`best_match`})}),_jsxs(_components.td,{children:[`Newest `,_jsx(_components.code,{children:`ended_at`}),` first (default)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ending_soonest`})}),_jsxs(_components.td,{children:[`Same order as `,_jsx(_components.code,{children:`best_match`}),`: eBay ignores it on sold listings`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`newly_listed`})}),_jsxs(_components.td,{children:[`Same order as `,_jsx(_components.code,{children:`best_match`}),`: eBay ignores it on sold listings`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`price_low_to_high`})}),_jsx(_components.td,{children:`Lowest sold price first`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`price_high_to_low`})}),_jsx(_components.td,{children:`Highest sold price first`})]})]})]})]}),`\n`,_jsxs(ParamField,{query:`condition`,type:`string`,id:`param-condition`,children:[_jsxs(_components.p,{children:[`Item condition filter (`,_jsx(_components.code,{children:`new`}),`, `,_jsx(_components.code,{children:`open_box`}),`, `,_jsx(_components.code,{children:`refurbished`}),`, `,_jsx(_components.code,{children:`used`}),`, `,_jsx(_components.code,{children:`for_parts`}),`).`]}),_jsxs(_components.p,{children:[`Trading cards also accept `,_jsx(_components.code,{children:`graded`}),` and `,_jsx(_components.code,{children:`ungraded`}),` — eBay’s card conditions for\nslabbed (PSA / BGS / CGC) versus raw cards. Pricing a raw card against sales\nthat include slabs skews the average badly, so price the two separately.`]})]}),`\n`,_jsxs(ParamField,{query:`location`,type:`string`,id:`param-location`,children:[_jsx(_components.p,{children:`Item location.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`domestic`})}),_jsxs(_components.td,{children:[`Only items located in this marketplace’s own country (`,_jsx(_components.code,{children:`domain=fr`}),` → France only)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`worldwide`})}),_jsx(_components.td,{children:`Items from every country`})]})]})]}),_jsxs(_components.p,{children:[`Omit it and you get eBay’s default, which mixes foreign listings into a national\nmarketplace. Two things follow from that, and both matter for price research:\na national price series picks up sales that never happened in that country, and\na foreign listing’s price is shown `,_jsx(_components.strong,{children:`converted`}),` into the marketplace’s currency\nrather than the amount it actually sold for. `,_jsx(_components.code,{children:`location=domestic`}),` removes both.`]}),_jsxs(_components.p,{children:[`Any other value returns `,_jsx(_components.code,{children:`400 invalid_location`}),` — it is never silently ignored.`]})]}),`\n`,_jsx(ParamField,{query:`min_price`,type:`number`,id:`param-min-price`,children:_jsx(_components.p,{children:`Minimum sold-price filter in the marketplace’s local currency.`})}),`\n`,_jsx(ParamField,{query:`max_price`,type:`number`,id:`param-max-price`,children:_jsx(_components.p,{children:`Maximum sold-price filter in the marketplace’s local currency.`})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[`Identical shape to `,_jsx(_components.a,{href:`/api-reference/endpoint/ebay/search`,children:_jsx(_components.code,{children:`/v1/ebay/search`})}),`, except `,_jsx(_components.code,{children:`sold`}),` is `,_jsx(_components.code,{children:`true`}),`, each result’s `,_jsx(_components.code,{children:`price`}),` reflects the `,_jsx(_components.strong,{children:`final sold price`}),`, and each result carries a `,_jsx(_components.code,{children:`sold_date`}),`.`]}),`\n`,_jsx(ResponseField,{name:`query`,type:`string`,id:`param-query-1`,children:`The search query that was executed.`}),`\n`,_jsx(ResponseField,{name:`domain`,type:`string`,id:`param-domain-1`,children:`Marketplace domain that was searched.`}),`\n`,_jsxs(ResponseField,{name:`sold`,type:`boolean`,id:`param-sold`,children:[`Always `,_jsx(_components.code,{children:`true`}),` for completed/sold listings.`]}),`\n`,_jsxs(ResponseField,{name:`results`,type:`array`,id:`param-results`,children:[_jsxs(_components.p,{children:[`Array of sold listings (same `,_jsx(_components.code,{children:`SearchResult`}),` shape as active search).`]}),_jsxs(Expandable,{title:`SearchResult object`,children:[_jsx(ResponseField,{name:`position`,type:`integer`,id:`param-position`,children:`Position on the page (1-based).`}),_jsx(ResponseField,{name:`item_id`,type:`string`,id:`param-item-id`,children:`eBay listing item id.`}),_jsx(ResponseField,{name:`title`,type:`string`,id:`param-title`,children:`Listing title.`}),_jsx(ResponseField,{name:`url`,type:`string`,id:`param-url`,children:`Full URL to the listing.`}),_jsx(ResponseField,{name:`image`,type:`string`,id:`param-image`,children:`Primary image URL.`}),_jsxs(ResponseField,{name:`price`,type:`object`,id:`param-price`,children:[`Final `,_jsx(_components.strong,{children:`sold`}),` price with `,_jsx(_components.code,{children:`value`}),`, `,_jsx(_components.code,{children:`currency`}),`, `,_jsx(_components.code,{children:`symbol`}),`, `,_jsx(_components.code,{children:`raw`}),`.`]}),_jsx(ResponseField,{name:`condition`,type:`string`,id:`param-condition-1`,children:`Item condition label.`}),_jsxs(ResponseField,{name:`buying_format`,type:`string`,id:`param-buying-format`,children:[_jsx(_components.code,{children:`Buy It Now`}),`, `,_jsx(_components.code,{children:`Auction`}),`, or `,_jsx(_components.code,{children:`Best Offer`}),`.`]}),_jsx(ResponseField,{name:`is_auction`,type:`boolean`,id:`param-is-auction`,children:`Whether the listing was an auction.`}),_jsx(ResponseField,{name:`bids`,type:`integer`,id:`param-bids`,children:`Number of bids the auction received (nullable).`}),_jsxs(ResponseField,{name:`current_bid`,type:`object`,id:`param-current-bid`,children:[`Winning bid for auction listings with `,_jsx(_components.code,{children:`value`}),`, `,_jsx(_components.code,{children:`currency`}),`, `,_jsx(_components.code,{children:`symbol`}),`, `,_jsx(_components.code,{children:`raw`}),`; mirrors `,_jsx(_components.code,{children:`price`}),`. Null for fixed-price listings.`]}),_jsx(ResponseField,{name:`shipping`,type:`string`,id:`param-shipping`,children:`Shipping text.`}),_jsx(ResponseField,{name:`location`,type:`string`,id:`param-location-1`,children:`Item location text.`}),_jsxs(ResponseField,{name:`sold_date`,type:`string`,id:`param-sold-date`,children:[`Sale date text as rendered by eBay, e.g. `,_jsx(_components.code,{children:`Aug 19, 2026`}),`. Localized on non-English marketplaces (e.g. `,_jsx(_components.code,{children:`Verkauft 5. Okt. 2024`}),`), nullable.`]}),_jsxs(ResponseField,{name:`sold_date_at`,type:`string`,id:`param-sold-date-at`,children:[`ISO date of eBay’s “Sold” label, e.g. `,_jsx(_components.code,{children:`2026-08-19`}),`: a day the item sold, on the marketplace’s calendar. On a multi-quantity listing eBay labels an earlier sale, months before `,_jsx(_components.code,{children:`ended_at`}),` at times. On non-English marketplaces it is the day `,_jsx(_components.code,{children:`ended_at`}),` falls on in Europe/Berlin.`]}),_jsxs(ResponseField,{name:`ended_at`,type:`string`,id:`param-ended-at`,children:[`When eBay last closed this listing out, in UTC to the minute, e.g. `,_jsx(_components.code,{children:`2026-08-19T14:31:00Z`}),`: the listing’s end, or the latest sale on a multi-quantity listing that is still live. Results are ordered by it, newest first.`]}),_jsx(ResponseField,{name:`seller_name`,type:`string`,id:`param-seller-name`,children:`Seller username (nullable).`}),_jsxs(ResponseField,{name:`is_sponsored`,type:`boolean`,id:`param-is-sponsored`,children:[`Always `,_jsx(_components.code,{children:`null`}),`. eBay renders its “Sponsored” badge into every card as anti-scraping bait, so promoted placements cannot be distinguished from organic results.`]})]})]}),`\n`,_jsx(ResponseField,{name:`facets`,type:`object`,id:`param-facets`,children:`Available filter facets keyed by name.`}),`\n`,_jsxs(ResponseField,{name:`pagination`,type:`object`,id:`param-pagination`,children:[_jsxs(_components.p,{children:[`Pagination metadata with `,_jsx(_components.code,{children:`current_page`}),`, `,_jsx(_components.code,{children:`per_page`}),`, `,_jsx(_components.code,{children:`total_results`}),`, `,_jsx(_components.code,{children:`has_more`}),`.`]}),_jsxs(_components.p,{children:[_jsx(_components.code,{children:`total_results`}),` is populated (the sold results page carries a match count). `,_jsx(_components.code,{children:`total_pages`}),` may be `,_jsx(_components.code,{children:`null`}),` — page with `,_jsx(_components.code,{children:`has_more`}),` rather than a fixed page total.`]})]}),`\n`,_jsx(ResponseField,{name:`scraped_at`,type:`string`,id:`param-scraped-at`,children:`ISO 8601 timestamp when the results were scraped.`}),`\n`,_jsx(Heading,{level:`3`,id:`example-response`,children:`Example Response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`30`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`30`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"query\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"nintendo switch\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"domain\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sold\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"results\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"position\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"item_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"256987654321\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"title\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Nintendo Switch (OLED Model) - Used\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://www.ebay.com/itm/256987654321\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"image\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://i.ebayimg.com/images/g/xyz/s-l500.jpg\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"price\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`260.0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"USD\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"symbol\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"$\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"raw\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"$260.00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"condition\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Pre-Owned\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"buying_format\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Auction\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"is_auction\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"bids\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`14`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"current_bid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`260.0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"USD\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"symbol\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"$\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"raw\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"$260.00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"shipping\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Free shipping\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"location\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"United States\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sold_date\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Aug 19, 2026\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sold_date_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-08-19\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ended_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-08-19T14:31:00Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"seller_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"gamerdeals99\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"is_sponsored\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"facets\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"pagination\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"current_page\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"per_page\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`60`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"total_pages\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"total_results\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`34000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"has_more\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"scraped_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-08-20T12:00:00Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`sold-listings-for-one-seller`,children:`Sold listings for one seller`}),`\n`,_jsxs(_components.p,{children:[`Pass `,_jsx(_components.code,{children:`seller`}),` without a `,_jsx(_components.code,{children:`query`}),` to page through everything one seller sold:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --get`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://scrapebadger.com/v1/ebay/completed'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'seller=musicmagpie'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'domain=co.uk'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'per_page=200'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'x-api-key: YOUR_API_KEY'`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Every result is one of that seller’s sales, and `,_jsx(_components.code,{children:`seller_name`}),` says so. Add\n`,_jsx(_components.code,{children:`query`}),`, `,_jsx(_components.code,{children:`category_id`}),`, `,_jsx(_components.code,{children:`condition`}),` or a price range to narrow it down. eBay\nhandles the request; no eBay account or cookies are needed on your side. How\nfar back it reaches is eBay’s own sold history for that marketplace.`]}),`\n`,_jsx(Heading,{level:`2`,id:`fetching-every-sold-listing`,children:`Fetching every sold listing`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`has_more`}),` is the stop signal for bulk extraction. Increment `,_jsx(_components.code,{children:`page`}),` while it is `,_jsx(_components.code,{children:`true`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`12`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`12`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`page, all_sold `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, []`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`while`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` True`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` r `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.get(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://scrapebadger.com/v1/ebay/completed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` params`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"query\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"iphone 13\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"per_page\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`200`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"page\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: page},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"X-API-Key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#D4D4D4`},children:`API_KEY`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ).json()`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` all_sold `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`+=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` r[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"results\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` if`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` not`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` r[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"results\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`] `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`or`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` not`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` r[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pagination\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`][`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"has_more\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]:`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` break`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` page `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`+=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 1`})]}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Do not loop on “until the response is empty” alone. Past its last page eBay\n`,_jsx(_components.strong,{children:`clamps`}),` — asking for page 200 of a 133-page result set re-serves page 133.\nThis API detects that and returns an empty page with `,_jsx(_components.code,{children:`has_more: false`}),`, but a\nclient that ignores `,_jsx(_components.code,{children:`has_more`}),` and retries forever will keep spending credits.`]})}),`\n`,_jsxs(_components.p,{children:[`Pages stop at `,_jsx(_components.code,{children:`100`}),`, so one search returns at most 20,000 listings at `,_jsx(_components.code,{children:`per_page=200`}),`; narrow a bigger result set with `,_jsx(_components.code,{children:`condition`}),`, `,_jsx(_components.code,{children:`category_id`}),` or a price range (`,_jsx(_components.code,{children:`min_price`}),` / `,_jsx(_components.code,{children:`max_price`}),`).\nUse the largest `,_jsx(_components.code,{children:`per_page`}),` you can: each request costs 8 credits regardless of page\nsize, so `,_jsx(_components.code,{children:`per_page=200`}),` is about 3x cheaper per listing than the default.`]}),`\n`,_jsx(Heading,{level:`2`,id:`collecting-one-day’s-sales`,children:`Collecting one day’s sales`}),`\n`,_jsxs(_components.p,{children:[`Results come newest `,_jsx(_components.code,{children:`ended_at`}),` first, so one day of a seller’s sales is a run of\nconsecutive pages. To collect a calendar day in your timezone:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Convert the day’s start and end to UTC (for `,_jsx(_components.code,{children:`Europe/London`}),` on 1 November,\n`,_jsx(_components.code,{children:`2026-11-01T00:00:00Z`}),` to `,_jsx(_components.code,{children:`2026-11-02T00:00:00Z`}),`).`]}),`\n`,_jsxs(_components.li,{children:[`Walk `,_jsx(_components.code,{children:`seller=\u003cusername>\u0026per_page=200\u0026page=1,2,…`}),`, keeping results whose\n`,_jsx(_components.code,{children:`ended_at`}),` falls inside that window.`]}),`\n`,_jsxs(_components.li,{children:[`Stop at the first page whose `,_jsx(_components.strong,{children:`last`}),` result has `,_jsx(_components.code,{children:`ended_at`}),` before the\nwindow’s start.`]}),`\n`,_jsxs(_components.li,{children:[`De-duplicate on `,_jsx(_components.code,{children:`item_id`}),`.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Things to know before you rely on the count:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`One result per listing, not per sale.`}),` A multi-quantity listing that sold\nseveral units appears once, at its latest sale. If it sells again after your\nday, it moves to that later time, so walk soon after the day ends.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`eBay’s sold index is not perfectly consistent.`}),` The same page can come back\nslightly different from one call to the next (one seller’s page 1 came back in\nthree versions, 217 listings between them, 200 each). A second walk later can\nreturn a few listings the first missed. Merge walks on `,_jsx(_components.code,{children:`item_id`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The sold history is eBay’s.`}),` It covers roughly the last 90 days.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`A walk of N pages costs 8 × N credits. Your API key’s per-minute limit counts\nevery `,_jsx(_components.code,{children:`/v1`}),` call, so space a long walk out; a `,_jsx(_components.code,{children:`429`}),` carries a `,_jsx(_components.code,{children:`Retry-After`}),`\nheader with the seconds to wait.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Each completed/sold request costs `,_jsx(_components.strong,{children:`8 credits`}),`. Failed requests are not charged.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Completed / Sold Listings","openapi":"GET /v1/ebay/completed","description":"Search eBay completed (sold) listings — the closing prices buyers actually paid.","href":"/api-reference/endpoint/ebay/completed"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Query Parameters","slug":"query-parameters","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[{"title":"Example Response","slug":"example-response","depth":3,"children":[]}]},{"title":"Sold listings for one seller","slug":"sold-listings-for-one-seller","depth":2,"children":[]},{"title":"Fetching every sold listing","slug":"fetching-every-sold-listing","depth":2,"children":[]},{"title":"Collecting one day’s sales","slug":"collecting-one-day’s-sales","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"searchEbayCompleted","summary":"Completed / Sold Listings","description":"Search eBay completed (sold) listings — the closing prices buyers actually paid.","tags":["eBay Search"],"parameters":["488c7ec2-0514-4360-beee-464394ceb669","3fbc4e00-9992-4900-a69c-36ffe422a700","e3acfdd2-73e1-43b0-a5d8-277b130d2e59","15593f47-2b84-469d-bd12-9063be563093","a661fab7-0daa-462b-b2e4-97fca1a32591","716e9df1-d774-486f-b6e1-00d0e5277792","8003af99-5c31-4cb0-a2ee-fdea7f4d1cbe","a77ba74a-4ee1-43af-bb96-2c53662664b4","17f7b58d-c121-4ece-8b69-3aeff9ef08e6","eb8c0fef-da50-4ce3-8eb2-944a036ad47a","54211933-32e7-4a25-91bc-029cc04f46ba"],"responses":{"200":"8bfeded0-0a53-4598-aba6-d264b0438875"},"method":"get","type":"path","servers":["51325be0-cbbe-4a68-b1ed-c0b33c890c49"],"security":["791516e2-e05a-456a-a841-a83bc84105ff"],"path":"/v1/ebay/completed","baseUrlOptions":["https://scrapebadger.com"],"title":"Completed / Sold Listings","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"488c7ec2-0514-4360-beee-464394ceb669":{"name":"query","in":"query","required":false,"schema":{"type":"string","isRequired":false,"description":"Search keywords. Optional when `seller` is set; send at least one of the two.","uniqueKey":"","typeLabel":"string"},"description":"Search keywords. Optional when `seller` is set; send at least one of the two."},"3fbc4e00-9992-4900-a69c-36ffe422a700":{"name":"seller","in":"query","required":false,"schema":{"type":"string","isRequired":false,"description":"Only this seller's sold listings (eBay username, e.g. `musicmagpie`). Works without `query`.","uniqueKey":"","typeLabel":"string"},"description":"Only this seller's sold listings (eBay username, e.g. `musicmagpie`). Works without `query`."},"e3acfdd2-73e1-43b0-a5d8-277b130d2e59":{"name":"domain","in":"query","schema":{"type":"string","default":"com","description":"eBay marketplace domain TLD or alias (com, co.uk, de, fr, ...).","uniqueKey":"","typeLabel":"string"},"description":"eBay marketplace domain TLD or alias (com, co.uk, de, fr, ...)."},"15593f47-2b84-469d-bd12-9063be563093":{"name":"category_id","in":"query","schema":{"type":"string","description":"Restrict results to a category id.","uniqueKey":"","typeLabel":"string"},"description":"Restrict results to a category id."},"a661fab7-0daa-462b-b2e4-97fca1a32591":{"name":"page","in":"query","schema":{"type":"integer","default":1,"minimum":1,"maximum":100,"description":"Page number for paginated results.","uniqueKey":"","typeLabel":"integer"},"description":"Page number for paginated results."},"716e9df1-d774-486f-b6e1-00d0e5277792":{"name":"per_page","in":"query","schema":{"type":"integer","minimum":1,"maximum":240,"description":"Results per page. Clamped to 60, 120 or 240; eBay puts at most 200 on a page, so 240 returns 200 and `pagination.per_page` says 200.","uniqueKey":"","typeLabel":"integer"},"description":"Results per page. Clamped to 60, 120 or 240; eBay puts at most 200 on a page, so 240 returns 200 and `pagination.per_page` says 200."},"8003af99-5c31-4cb0-a2ee-fdea7f4d1cbe":{"name":"sort_by","in":"query","schema":{"type":"string","default":"best_match","enum":["best_match","ending_soonest","newly_listed","price_low_to_high","price_high_to_low"],"description":"Sort order. On sold listings eBay applies only the price sorts; `best_match`, `ending_soonest` and `newly_listed` all return the default order, newest `ended_at` first.","uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"Sort order. On sold listings eBay applies only the price sorts; `best_match`, `ending_soonest` and `newly_listed` all return the default order, newest `ended_at` first."},"a77ba74a-4ee1-43af-bb96-2c53662664b4":{"name":"condition","in":"query","schema":{"type":"string","enum":["new","open_box","refurbished","used","for_parts","graded","ungraded"],"description":"Item condition. `graded` / `ungraded` are eBay's trading-card conditions — slabbed (PSA/BGS/CGC) vs raw — so a card can be priced separately from its slabs.","uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"Item condition. `graded` / `ungraded` are eBay's trading-card conditions — slabbed (PSA/BGS/CGC) vs raw — so a card can be priced separately from its slabs."},"17f7b58d-c121-4ece-8b69-3aeff9ef08e6":{"name":"min_price","in":"query","schema":{"type":"number","minimum":0,"description":"Minimum price filter in the marketplace's local currency.","uniqueKey":"","typeLabel":"number"},"description":"Minimum price filter in the marketplace's local currency."},"eb8c0fef-da50-4ce3-8eb2-944a036ad47a":{"name":"max_price","in":"query","schema":{"type":"number","minimum":0,"description":"Maximum price filter in the marketplace's local currency.","uniqueKey":"","typeLabel":"number"},"description":"Maximum price filter in the marketplace's local currency."},"54211933-32e7-4a25-91bc-029cc04f46ba":{"name":"location","in":"query","required":false,"description":"Item location. `domestic` returns only items located in this marketplace's own country (`domain=fr` → France only); `worldwide` widens to every country. Foreign listings are priced in the marketplace's currency after eBay CONVERTS them, so `domestic` is also how you get untouched native sale prices.","schema":{"type":"string","enum":["domestic","worldwide"],"isRequired":false,"description":"Item location. `domestic` returns only items located in this marketplace's own country (`domain=fr` → France only); `worldwide` widens to every country. Foreign listings are priced in the marketplace's currency after eBay CONVERTS them, so `domestic` is also how you get untouched native sale prices.","uniqueKey":"","typeLabel":"enum\u003cstring>"}}},"responses":{"8bfeded0-0a53-4598-aba6-d264b0438875":{"description":"Completed / sold listings","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"oneOf":[{"type":"string","uniqueKey":"query.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"query.oneOf.1","typeLabel":"null"}],"uniqueKey":"query","typeLabel":"string | null"},"domain":{"type":"string","uniqueKey":"domain","typeLabel":"string"},"category_id":{"oneOf":[{"type":"string","uniqueKey":"category_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"category_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"category_id","typeLabel":"string | null"},"sold":{"type":"boolean","uniqueKey":"sold","typeLabel":"boolean"},"results":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer","uniqueKey":"results.items.[INDEX].position","typeLabel":"integer"},"item_id":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].item_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].item_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].item_id","typeLabel":"string | null"},"product_id":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].product_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].product_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].product_id","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].title","typeLabel":"string | null"},"url":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].url","typeLabel":"string | null"},"image":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].image.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].image.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].image","typeLabel":"string | null"},"price":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","uniqueKey":"results.items.[INDEX].price.value.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"results.items.[INDEX].price.value.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].price.value","typeLabel":"number | null"},"currency":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].price.currency.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].price.currency.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].price.currency","typeLabel":"string | null"},"symbol":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].price.symbol.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].price.symbol.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].price.symbol","typeLabel":"string | null"},"raw":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].price.raw.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].price.raw.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].price.raw","typeLabel":"string | null"}},"uniqueKey":"results.items.[INDEX].price","typeLabel":"object"},"original_price":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","uniqueKey":"results.items.[INDEX].original_price.value.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"results.items.[INDEX].original_price.value.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].original_price.value","typeLabel":"number | null"},"currency":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].original_price.currency.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].original_price.currency.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].original_price.currency","typeLabel":"string | null"},"symbol":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].original_price.symbol.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].original_price.symbol.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].original_price.symbol","typeLabel":"string | null"},"raw":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].original_price.raw.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].original_price.raw.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].original_price.raw","typeLabel":"string | null"}},"uniqueKey":"results.items.[INDEX].original_price","typeLabel":"object"},"discount_percent":{"oneOf":[{"type":"number","uniqueKey":"results.items.[INDEX].discount_percent.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"results.items.[INDEX].discount_percent.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].discount_percent","typeLabel":"number | null"},"currency":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].currency.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].currency.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].currency","typeLabel":"string | null"},"condition":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].condition.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].condition.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].condition","typeLabel":"string | null"},"brand":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].brand.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].brand.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].brand","typeLabel":"string | null"},"buying_format":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].buying_format.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].buying_format.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].buying_format","typeLabel":"string | null"},"is_auction":{"type":"boolean","uniqueKey":"results.items.[INDEX].is_auction","typeLabel":"boolean"},"bids":{"oneOf":[{"type":"integer","uniqueKey":"results.items.[INDEX].bids.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"results.items.[INDEX].bids.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].bids","typeLabel":"integer | null"},"time_left":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].time_left.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].time_left.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].time_left","typeLabel":"string | null"},"current_bid":{"oneOf":[{"type":"object","description":"Current high bid for auction listings; mirrors `price`. Null for non-auction (fixed-price) listings.","properties":{"value":{"oneOf":[{"type":"number","uniqueKey":"results.items.[INDEX].current_bid.oneOf.0.value.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"results.items.[INDEX].current_bid.oneOf.0.value.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].current_bid.oneOf.0.value","typeLabel":"number | null"},"currency":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].current_bid.oneOf.0.currency.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].current_bid.oneOf.0.currency.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].current_bid.oneOf.0.currency","typeLabel":"string | null"},"symbol":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].current_bid.oneOf.0.symbol.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].current_bid.oneOf.0.symbol.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].current_bid.oneOf.0.symbol","typeLabel":"string | null"},"raw":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].current_bid.oneOf.0.raw.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].current_bid.oneOf.0.raw.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].current_bid.oneOf.0.raw","typeLabel":"string | null"}},"uniqueKey":"results.items.[INDEX].current_bid.oneOf.0","typeLabel":"object"},{"type":"null","description":"Current high bid for auction listings; mirrors `price`. Null for non-auction (fixed-price) listings.","properties":{"value":{"oneOf":[{"type":"number"},{"type":"null"}]},"currency":{"oneOf":[{"type":"string"},{"type":"null"}]},"symbol":{"oneOf":[{"type":"string"},{"type":"null"}]},"raw":{"oneOf":[{"type":"string"},{"type":"null"}]}},"uniqueKey":"results.items.[INDEX].current_bid.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].current_bid","typeLabel":"object | null"},"shipping":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].shipping.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].shipping.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].shipping","typeLabel":"string | null"},"shipping_cost":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","uniqueKey":"results.items.[INDEX].shipping_cost.value.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"results.items.[INDEX].shipping_cost.value.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].shipping_cost.value","typeLabel":"number | null"},"currency":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].shipping_cost.currency.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].shipping_cost.currency.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].shipping_cost.currency","typeLabel":"string | null"},"symbol":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].shipping_cost.symbol.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].shipping_cost.symbol.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].shipping_cost.symbol","typeLabel":"string | null"},"raw":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].shipping_cost.raw.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].shipping_cost.raw.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].shipping_cost.raw","typeLabel":"string | null"}},"uniqueKey":"results.items.[INDEX].shipping_cost","typeLabel":"object"},"free_shipping":{"oneOf":[{"type":"boolean","uniqueKey":"results.items.[INDEX].free_shipping.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"results.items.[INDEX].free_shipping.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].free_shipping","typeLabel":"boolean | null"},"location":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].location.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].location.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].location","typeLabel":"string | null"},"returns":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].returns.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].returns.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].returns","typeLabel":"string | null"},"sold_count":{"oneOf":[{"type":"integer","uniqueKey":"results.items.[INDEX].sold_count.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"results.items.[INDEX].sold_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].sold_count","typeLabel":"integer | null"},"sold_date":{"oneOf":[{"type":"string","description":"Sale date text as rendered by eBay on the sold card, e.g. \"2 Jul 2026\". Localized on non-English marketplaces (e.g. \"Verkauft 5. Okt. 2024\"). Null on active listings.","examples":["2 Jul 2026"],"uniqueKey":"results.items.[INDEX].sold_date.oneOf.0","typeLabel":"string"},{"type":"null","description":"Sale date text as rendered by eBay on the sold card, e.g. \"2 Jul 2026\". Localized on non-English marketplaces (e.g. \"Verkauft 5. Okt. 2024\"). Null on active listings.","examples":["2 Jul 2026"],"uniqueKey":"results.items.[INDEX].sold_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].sold_date","typeLabel":"string | null"},"sold_date_at":{"oneOf":[{"type":"string","description":"ISO 8601 date of eBay's \"Sold\" label, e.g. \"2026-07-02\": a day the item sold, on the marketplace's calendar. On a multi-quantity listing eBay labels an earlier sale, months before `ended_at` at times. On non-English marketplaces, the day `ended_at` falls on in Europe/Berlin.","examples":["2026-07-02"],"uniqueKey":"results.items.[INDEX].sold_date_at.oneOf.0","typeLabel":"string"},{"type":"null","description":"ISO 8601 date of eBay's \"Sold\" label, e.g. \"2026-07-02\": a day the item sold, on the marketplace's calendar. On a multi-quantity listing eBay labels an earlier sale, months before `ended_at` at times. On non-English marketplaces, the day `ended_at` falls on in Europe/Berlin.","examples":["2026-07-02"],"uniqueKey":"results.items.[INDEX].sold_date_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].sold_date_at","typeLabel":"string | null"},"ended_at":{"oneOf":[{"type":"string","format":"date-time","description":"When eBay last closed this listing out, in UTC to the minute: the listing's end, or the latest sale on a multi-quantity listing that is still live. Results are ordered by it, newest first. Bucket sales by day on this field, converted to your timezone.","examples":["2026-07-02T14:31:00Z"],"uniqueKey":"results.items.[INDEX].ended_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When eBay last closed this listing out, in UTC to the minute: the listing's end, or the latest sale on a multi-quantity listing that is still live. Results are ordered by it, newest first. Bucket sales by day on this field, converted to your timezone.","examples":["2026-07-02T14:31:00Z"],"uniqueKey":"results.items.[INDEX].ended_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].ended_at","typeLabel":"string\u003cdate-time> | null"},"watchers":{"oneOf":[{"type":"integer","uniqueKey":"results.items.[INDEX].watchers.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"results.items.[INDEX].watchers.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].watchers","typeLabel":"integer | null"},"coupon":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].coupon.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].coupon.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].coupon","typeLabel":"string | null"},"rating":{"oneOf":[{"type":"number","uniqueKey":"results.items.[INDEX].rating.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"results.items.[INDEX].rating.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].rating","typeLabel":"number | null"},"ratings_total":{"oneOf":[{"type":"integer","uniqueKey":"results.items.[INDEX].ratings_total.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"results.items.[INDEX].ratings_total.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].ratings_total","typeLabel":"integer | null"},"seller_name":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].seller_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].seller_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].seller_name","typeLabel":"string | null"},"seller_feedback_percent":{"oneOf":[{"type":"number","uniqueKey":"results.items.[INDEX].seller_feedback_percent.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"results.items.[INDEX].seller_feedback_percent.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].seller_feedback_percent","typeLabel":"number | null"},"seller_feedback_score":{"oneOf":[{"type":"integer","uniqueKey":"results.items.[INDEX].seller_feedback_score.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"results.items.[INDEX].seller_feedback_score.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].seller_feedback_score","typeLabel":"integer | null"},"program_badge":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].program_badge.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].program_badge.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].program_badge","typeLabel":"string | null"},"is_sponsored":{"oneOf":[{"type":"boolean","description":"Always null — eBay renders its Sponsored badge into every card as anti-scraping bait, so promoted placements cannot be distinguished from organic results.","uniqueKey":"results.items.[INDEX].is_sponsored.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Always null — eBay renders its Sponsored badge into every card as anti-scraping bait, so promoted placements cannot be distinguished from organic results.","uniqueKey":"results.items.[INDEX].is_sponsored.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].is_sponsored","typeLabel":"boolean | null"}},"uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"uniqueKey":"results","typeLabel":"object[]"},"facets":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"facets.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"facets.additionalProperties","typeLabel":"string[]"},"uniqueKey":"facets","typeLabel":"object"},"pagination":{"type":"object","properties":{"current_page":{"type":"integer","uniqueKey":"pagination.current_page","typeLabel":"integer"},"per_page":{"oneOf":[{"type":"integer","uniqueKey":"pagination.per_page.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"pagination.per_page.oneOf.1","typeLabel":"null"}],"uniqueKey":"pagination.per_page","typeLabel":"integer | null"},"total_pages":{"oneOf":[{"type":"integer","uniqueKey":"pagination.total_pages.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"pagination.total_pages.oneOf.1","typeLabel":"null"}],"uniqueKey":"pagination.total_pages","typeLabel":"integer | null"},"total_results":{"oneOf":[{"type":"integer","uniqueKey":"pagination.total_results.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"pagination.total_results.oneOf.1","typeLabel":"null"}],"uniqueKey":"pagination.total_results","typeLabel":"integer | null"},"has_more":{"oneOf":[{"type":"boolean","description":"True while eBay still offers a next page — the stop signal for bulk extraction. total_results is populated on completed/sold; total_pages may be null. Past the last page eBay re-serves it, so page on has_more rather than looping until empty.","uniqueKey":"pagination.has_more.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"True while eBay still offers a next page — the stop signal for bulk extraction. total_results is populated on completed/sold; total_pages may be null. Past the last page eBay re-serves it, so page on has_more rather than looping until empty.","uniqueKey":"pagination.has_more.oneOf.1","typeLabel":"null"}],"uniqueKey":"pagination.has_more","typeLabel":"boolean | null"}},"uniqueKey":"pagination","typeLabel":"object"},"scraped_utc":{"oneOf":[{"type":"number","uniqueKey":"scraped_utc.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"scraped_utc.oneOf.1","typeLabel":"null"}],"uniqueKey":"scraped_utc","typeLabel":"number | null"},"scraped_at":{"oneOf":[{"type":"string","uniqueKey":"scraped_at.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"scraped_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"scraped_at","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"query":"\u003cstring>","domain":"\u003cstring>","category_id":"\u003cstring>","sold":true,"results":[{"position":123,"item_id":"\u003cstring>","product_id":"\u003cstring>","title":"\u003cstring>","url":"\u003cstring>","image":"\u003cstring>","price":{"value":123,"currency":"\u003cstring>","symbol":"\u003cstring>","raw":"\u003cstring>"},"original_price":{"value":123,"currency":"\u003cstring>","symbol":"\u003cstring>","raw":"\u003cstring>"},"discount_percent":123,"currency":"\u003cstring>","condition":"\u003cstring>","brand":"\u003cstring>","buying_format":"\u003cstring>","is_auction":true,"bids":123,"time_left":"\u003cstring>","current_bid":{"value":123,"currency":"\u003cstring>","symbol":"\u003cstring>","raw":"\u003cstring>"},"shipping":"\u003cstring>","shipping_cost":{"value":123,"currency":"\u003cstring>","symbol":"\u003cstring>","raw":"\u003cstring>"},"free_shipping":true,"location":"\u003cstring>","returns":"\u003cstring>","sold_count":123,"sold_date":"2 Jul 2026","sold_date_at":"2026-07-02","ended_at":"2026-07-02T14:31:00Z","watchers":123,"coupon":"\u003cstring>","rating":123,"ratings_total":123,"seller_name":"\u003cstring>","seller_feedback_percent":123,"seller_feedback_score":123,"program_badge":"\u003cstring>","is_sponsored":true}],"facets":{},"pagination":{"current_page":123,"per_page":123,"total_pages":123,"total_results":123,"has_more":true},"scraped_utc":123,"scraped_at":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"791516e2-e05a-456a-a841-a83bc84105ff":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"apiKeyAuth"}}},"servers":{"51325be0-cbbe-4a68-b1ed-c0b33c890c49":{"url":"https://scrapebadger.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"apiKeyAuth"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"x-api-key"}],"title":"apiKeyAuth"}]},"originalFileLocation":"openapi-ebay.json"},"subdomain":"scrapebadger","siteName":"ScrapeBadger","title":"Completed / Sold Listings - ScrapeBadger","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-01T17:17:45.365Z","originalFileLocation":"api-reference/endpoint/ebay/completed.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Search eBay completed (sold) listings — the closing prices buyers actually paid.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ScrapeBadger\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Completed / Sold Listings - ScrapeBadger\">\u003cmeta data-mint-head property=\"og:description\" content=\"Search eBay completed (sold) listings — the closing prices buyers actually paid.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ScrapeBadger\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.scrapebadger.com/api-reference/endpoint/ebay/completed\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://scrapebadger.mintlify.site/_mintlify/api/og/v2?division=Search\u0026amp;title=Completed+%2F+Sold+Listings\u0026amp;description=Search+eBay+completed+%28sold%29+listings+%E2%80%94+the+closing+prices+buyers+actually+paid.\u0026amp;theme=a8afda73f3529961ad914289\u0026amp;signature=39edc1e56ce5905662082e87d7d64cecc5df294389291065c3294a417e052c14\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Completed / Sold Listings - ScrapeBadger\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Search eBay completed (sold) listings — the closing prices buyers actually paid.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://scrapebadger.mintlify.site/_mintlify/api/og/v2?division=Search\u0026amp;title=Completed+%2F+Sold+Listings\u0026amp;description=Search+eBay+completed+%28sold%29+listings+%E2%80%94+the+closing+prices+buyers+actually+paid.\u0026amp;theme=a8afda73f3529961ad914289\u0026amp;signature=39edc1e56ce5905662082e87d7d64cecc5df294389291065c3294a417e052c14\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ScrapeBadger\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.scrapebadger.com/api-reference/endpoint/ebay/completed\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/ebay/completed.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.scrapebadger.com/#organization\",\"name\":\"ScrapeBadger\",\"url\":\"https://docs.scrapebadger.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/scrapebadger/gnGR4eL2rEJ4E7w3/logo/light.png?fit=max\u0026auto=format\u0026n=gnGR4eL2rEJ4E7w3\u0026q=85\u0026s=d393e30b48870f8495f788d1fad76ad3\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.scrapebadger.com#website\",\"name\":\"ScrapeBadger\",\"url\":\"https://docs.scrapebadger.com\",\"publisher\":{\"@id\":\"https://docs.scrapebadger.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.scrapebadger.com/api-reference/endpoint/ebay/completed#webpage\",\"url\":\"https://docs.scrapebadger.com/api-reference/endpoint/ebay/completed\",\"name\":\"Completed / Sold Listings\",\"description\":\"Search eBay completed (sold) listings — the closing prices buyers actually paid.\",\"dateModified\":\"2026-11-01T17:17:45.365Z\",\"isPartOf\":{\"@id\":\"https://docs.scrapebadger.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.scrapebadger.com/api-reference/endpoint/ebay/completed#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.scrapebadger.com/api-reference/endpoint/ebay/completed#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Search\",\"item\":\"https://docs.scrapebadger.com/api-reference/endpoint/ebay/search\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Completed / Sold Listings\",\"item\":\"https://docs.scrapebadger.com/api-reference/endpoint/ebay/completed\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.scrapebadger.com/api-reference/endpoint/ebay/completed#apireference\",\"headline\":\"Completed / Sold Listings\",\"name\":\"Completed / Sold Listings\",\"description\":\"Search eBay completed (sold) listings — the closing prices buyers actually paid.\",\"url\":\"https://docs.scrapebadger.com/api-reference/endpoint/ebay/completed\",\"mainEntityOfPage\":{\"@id\":\"https://docs.scrapebadger.com/api-reference/endpoint/ebay/completed#webpage\"},\"dateModified\":\"2026-11-01T17:17:45.365Z\",\"publisher\":{\"@id\":\"https://docs.scrapebadger.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.scrapebadger.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ScrapeBadger\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"ScrapeBadger","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"gauge","href":"https://scrapebadger.com/dashboard?utm_source=docs\u0026utm_medium=referral"},{"anchor":"Pricing","icon":"credit-card","href":"https://scrapebadger.com/pricing"}]},"tabs":[{"tab":"Getting Started","pages":[{"title":"Getting Started","href":""}]},{"tab":"Web Scraping","pages":[{"title":"Web Scraping","href":"/web-scraping/overview"}]},{"tab":"Google","pages":[{"title":"Google","href":"/google/overview"}]},{"tab":"Baidu","pages":[{"title":"Baidu","href":"/baidu/overview"}]},{"tab":"Bing","pages":[{"title":"Bing","href":"/bing/overview"}]},{"tab":"DuckDuckGo","pages":[{"title":"DuckDuckGo","href":"/duckduckgo/overview"}]},{"tab":"Yahoo","pages":[{"title":"Yahoo","href":"/yahoo/overview"}]},{"tab":"Yandex","pages":[{"title":"Yandex","href":"/yandex/overview"}]},{"tab":"Naver","pages":[{"title":"Naver","href":"/naver/overview"}]},{"tab":"Reddit","pages":[{"title":"Reddit","href":"/reddit/overview"}]},{"tab":"Vinted","pages":[{"title":"Vinted","href":"/vinted/overview"}]},{"tab":"Depop","pages":[{"title":"Depop","href":"/depop/overview"}]},{"tab":"Wallapop","pages":[{"title":"Wallapop","href":"/wallapop/overview"}]},{"tab":"LinkedIn","pages":[{"title":"LinkedIn","href":"/linkedin/overview"}]},{"tab":"Amazon","pages":[{"title":"Amazon","href":"/amazon/overview"}]},{"tab":"eBay","groups":[{"group":"Overview","pages":[{"title":"eBay Scraper by ScrapeBadger — Overview","href":"/ebay/overview"}]},{"group":"Search","pages":[{"title":"Search Listings","openapi":"GET /v1/ebay/search","href":"/api-reference/endpoint/ebay/search"},{"title":"Search by Image","openapi":"POST /v1/ebay/search/by-image","description":"Search eBay with a photo instead of keywords, using eBay's own visual search.","href":"/api-reference/endpoint/ebay/search-by-image"},{"title":"Completed / Sold Listings","openapi":"GET /v1/ebay/completed","href":"/api-reference/endpoint/ebay/completed"},{"title":"Keyword Suggestions","openapi":"GET /v1/ebay/autocomplete","description":"eBay keyword autocomplete suggestions for a partial query.","href":"/api-reference/endpoint/ebay/autocomplete"}]},{"group":"Items","pages":[{"title":"Get Item Detail","openapi":"GET /v1/ebay/items/{item_id}","href":"/api-reference/endpoint/ebay/get-item-detail"},{"title":"Get Item Reviews","openapi":"GET /v1/ebay/items/{item_id}/reviews","href":"/api-reference/endpoint/ebay/get-item-reviews"}]},{"group":"Sellers","pages":[{"title":"Get Seller Profile","openapi":"GET /v1/ebay/sellers/{username}","href":"/api-reference/endpoint/ebay/get-seller"},{"title":"Get Seller Listings","openapi":"GET /v1/ebay/sellers/{username}/items","href":"/api-reference/endpoint/ebay/get-seller-items"},{"title":"Get Seller Feedback","openapi":"GET /v1/ebay/sellers/{username}/feedback","href":"/api-reference/endpoint/ebay/get-seller-feedback"}]},{"group":"Categories","pages":[{"title":"Browse a Category","openapi":"GET /v1/ebay/categories/{category_id}/items","href":"/api-reference/endpoint/ebay/browse-category"},{"title":"List Categories","openapi":"GET /v1/ebay/categories","href":"/api-reference/endpoint/ebay/list-categories"}]},{"group":"Reference","pages":[{"title":"List Markets","openapi":"GET /v1/ebay/markets","href":"/api-reference/endpoint/ebay/list-markets"}]}]},{"tab":"Walmart","pages":[{"title":"Walmart","href":"/walmart/overview"}]},{"tab":"Google Play","pages":[{"title":"Google Play","href":"/google-play/overview"}]},{"tab":"App Store","pages":[{"title":"App Store","href":"/app-store/overview"}]},{"tab":"Leboncoin","pages":[{"title":"Leboncoin","href":"/leboncoin/overview"}]},{"tab":"Gumtree","pages":[{"title":"Gumtree","href":"/gumtree/overview"}]},{"tab":"Immobiliare","pages":[{"title":"Immobiliare","href":"/immobiliare/overview"}]},{"tab":"LoopNet","pages":[{"title":"LoopNet","href":"/loopnet/overview"}]},{"tab":"Airbnb","pages":[{"title":"Airbnb","href":"/airbnb/overview"}]},{"tab":"Booking.com","pages":[{"title":"Booking.com","href":"/booking/overview"}]},{"tab":"Apartments.com","pages":[{"title":"Apartments.com","href":"/apartments/overview"}]},{"tab":"Realtor","pages":[{"title":"Realtor","href":"/realtor/overview"}]},{"tab":"Zillow","pages":[{"title":"Zillow","href":"/zillow/overview"}]},{"tab":"YouTube","pages":[{"title":"YouTube","href":"/youtube/overview"}]},{"tab":"Instagram","pages":[{"title":"Instagram","href":"/instagram/overview"}]},{"tab":"Facebook","pages":[{"title":"Facebook","href":"/facebook/overview"}]},{"tab":"TikTok","pages":[{"title":"TikTok","href":"/tiktok/overview"}]},{"tab":"Twitter","pages":[{"title":"Twitter","href":"/api-reference/introduction"}]},{"tab":"ChatGPT","pages":[{"title":"ChatGPT","href":"/chatgpt/overview"}]},{"tab":"Gemini","pages":[{"title":"Gemini","href":"/gemini/overview"}]},{"tab":"Perplexity","pages":[{"title":"Perplexity","href":"/api-reference/endpoint/perplexity/ask"}]},{"tab":"Copilot","pages":[{"title":"Copilot","href":"/copilot/overview"}]},{"tab":"MCP Server","pages":[{"title":"MCP Server","href":"/mcp/overview"}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/cli/overview"}]},{"tab":"ASOS","pages":[{"title":"ASOS","href":"/asos/overview"}]},{"tab":"Target","pages":[{"title":"Target","href":"/target/overview"}]},{"tab":"Etsy","pages":[{"title":"Etsy","href":"/etsy/overview"}]},{"tab":"AliExpress","pages":[{"title":"AliExpress","href":"/aliexpress/overview"}]},{"tab":"Best Buy","pages":[{"title":"Best Buy","href":"/bestbuy/overview"}]}]},"basePath":"","title":"Completed / Sold Listings - ScrapeBadger","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-i2a3QZ8E.js","utils-ChLwp8m0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DRktVTDc.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CA2pEs4T.js","snippetPresets-ClQ6XrKD.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ct_Lv36y.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Cn2PYw9e.js","shallow-rkyymjXQ.js","getApiPlaygroundDisplay-BB9vkXtE.js","CodeSnippet-Bm5RU7m1.js","CodeSnippets-BgU9Deuz.js","Page-BUDYNlhG.js","getPastedJson-BD-6NNum.js","icon-8Z6tud2e.js","MethodPill-Tuzr4g3V.js","DuplicateIcon-0ceWFYhN.js","createIcon-FBXow_ST.js","DynamicMarkdown-CD8713Yy.js","SectionHeading-7zgzQbH-.js","axios-vUo_bRtp.js","Markdown-D7Ofw1oz.js","clsx-eKJ4rcii.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CwjSCXIK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-9EK5IAXV.js"]}