Mercari sold status
- FixedMercari: items from a sold=true search now have status "sold".
What's new in SoldComps.
Highlights
Use SoldComps from Claude Code, Cursor, VS Code and other AI tools.
Find sold listings from a photo.
eBay searches now return a full page of up to 240 items. `count` picks the page size: 60, 120 or 240.
Search TCGPlayer products by keyword and pull recent sales history by product ID. Pricing, card metadata, and seller listings — same auth and quota as eBay endpoints. Currently in beta — may return errors under heavy load. Failed requests are not charged against your quota.
Look up any eBay listing by item ID and get the full detail page data: item specifics, all images, seller info, condition, shipping, location, category, and more. Works for both sold and active listings.
Search Mercari sold listings alongside eBay and Poshmark — same auth, same middleware, same API shape. Up to 100 items per page, with filters for price, condition, category, brand, and sort order. Currently in beta — may return errors under heavy load. Failed requests are not charged against your quota.
Buy API request credits without a subscription commitment. Credits never expire, work alongside your plan, and kick in automatically when your monthly quota runs out.
Filter by eBay sidebar facets like Brand, Grade, Storage Capacity, and Network. Pass a JSON object — facet names match what you see on eBay.
Search Poshmark sold listings alongside eBay — same auth, same middleware, same API shape. Optionally enrich each listing with detailed seller and timing data.
postalCode query parameter: pass a delivery postal code for more accurate shipping prices.enrich is no longer needed. New fields, filters and changed fields are listed in the docs: sold-comps.com/docs#poshmark-sold.soldPriceMax field on sold items: the high end of the price range eBay shows for a listing with variations (e.g. "$2.98 to $10.36"). soldPrice is the low end. null when eBay shows one price.buyItNowPrice field: on an auction that also offers Buy It Now, the fixed price to buy the item at once. null for other listings.currentPriceMax is now null on an auction that also has a Buy It Now price. Before, it was the Buy It Now price, which is now in buyItNowPrice.variantId parameter on GET /v1/tcgplayer/sales: returns up to 5 of the most recent sales of one printing. The IDs for each product line are at sold-comps.com/tcgplayer-variants.language looked only among the 5 most recent sales of the product, so it could return fewer than 5 sales. It now returns up to 5 of the most recent sales in that language.language accepts the 11 TCGPlayer languages (English, Chinese (S), Chinese (T), French, German, Italian, Japanese, Korean, Portuguese, Russian, Spanish), not case-sensitive. Another value is now ignored, so the request returns sales in any language.GET /v1/item has five new fields: listingStatus (sold, ended_by_seller, ended_unsold, out_of_stock, active or unknown), statusMessage (eBay's own status sentence), quantityAvailable, quantityAvailableText and quantitySold.GET /v1/scrape/category with page above 100 now returns 400 with code: "page_limit" at once, in place of a slow 503. The request is not counted. This is a breaking change for callers that request pages past 100. ebay.ca and ebay.com.au are not changed. GET /requests shows these requests with error: "page_limit", a new value of that field.GET /v1/tcgplayer/sales with condition looked for that condition only among the 5 most recent sales of the product, so it often returned no sales. It now returns up to 5 of the most recent sales of that condition. TCGPlayer makes 5 sales public for a request, on every plan; one request per condition gives up to 5 sales of each.GET /v1/item/{itemId} returned the asking price for a listing that sold through an accepted Best Offer. price is now the accepted amount shown on the eBay listing page.GET /v1/item/{itemId} has a new field, originalPrice: the list price eBay shows struck through next to the sold price. It is null when the page shows none.hydrateBoa=true found no accepted prices for items listed on ebay.co.uk and ebay.de. On searches of those two sites it now reads eBay's Price Guide on that site first, so soldPrice for such an item becomes the accepted amount in GBP or EUR. Items listed on ebay.com are matched as before.GET /usage returns your plan, the requests used and remaining in the current billing period, the reset time, your per-minute rate limit and your credit balance. Same API key as the search endpoints.GET /requests lists the requests made by your account, newest first, with the search parameters, result count, duration and success of each one. Filter by day with from / to (YYYY-MM-DD) and page with cursor. History goes back up to 90 days.200 with an empty items array and hasNextPage: false on /v1/scrape, /v1/scrape/category and /rapidapi/scrape-ebay. Stop paging when hasNextPage is false.lastPage (the last page eBay returns for the search), code: "past_last_page" and a message, plus an X-Past-Last-Page header. They count as 1 request, like any other 200.count is now a page size of 60, 120 or 240 on /v1/scrape, /v1/scrape/category, /rapidapi/scrape-ebay and /api/bulk-search. Other values are still accepted and rounded up to the next size (count=40 returns up to 60, count=200 returns up to 240), so a request can return more items than count. The default is 240 (was 40). Still 1 quota slot per request.503 response with code: "at_capacity" when capacity for an eBay site is temporarily exhausted. Retry shortly — on direct plans these requests don't count against your monthly quota.503 with code: "upstream_blocked" (was 502). Our edge network replaced 502 bodies with an HTML page, so clients never saw the JSON error — 503 bodies come through intact. Retry either 503 after a few seconds; neither is charged on direct plans.GET /v1/tcgplayer/search endpoint — search TCGPlayer products by keyword. Each item includes market price, lowest listing price, median price, set name, rarity, card number, and up to 3 of the cheapest seller listings with price/shipping/condition/seller detail. Same auth and middleware stack as the eBay endpoints. Each page costs 1 quota slot.GET /v1/tcgplayer/sales endpoint — recent sold-listing data for a TCGPlayer product ID. Each sale includes price, shipping cost, condition, printing variant, quantity, and sold date. Filter by condition, variant, or language. Each request costs 1 quota slot.hydrateBoa query parameter (default false) on all sold-item endpoints. When true, items sold via Best Offer have their soldPrice updated to the actual accepted offer amount using eBay's Price Guide. Surfaces boaAcceptedPrice and boaAcceptedCurrency for cross-currency cases. Primarily useful for trading card categories. Non-card categories silently skip. Costs 1 additional request when hydration finds at least one match — at most 1 extra per request regardless of how many items were hydrated. No extra charge on misses.itemCondition query parameter (new / used) was not being mapped to eBay's condition ID on the primary fetch path — only the numeric conditionId parameter worked. Both now filter correctly.GET /v1/item/{itemId} endpoint — pass an eBay item number (or full URL) and get the complete listing detail: item specifics (Brand, Model, Storage Capacity, Color, etc.), full-resolution images, seller username and feedback, condition, shipping cost, item location, return policy, category breadcrumb, ended date, and bid count. Same auth and quota as /v1/scrape — each call costs 1 request.includeDescription=true parameter fetches the seller's item description as sanitized plain text (~200ms extra latency, no additional quota cost).ebaySite parameter. Prices and shipping are returned in the local currency of the requested site (e.g. GBP on ebay.co.uk, EUR on ebay.de).GET /v1/mercari endpoint — search Mercari sold listings by keyword. Returns up to 100 items per page with normalized fields (price in dollars, condition labels, direct image URLs). Same auth and middleware stack as the eBay and Poshmark endpoints.sortOrder (bestMatch, newest, lowestPrice, highestPrice, mostPopular), minPrice/maxPrice (in dollars), itemCondition (new, likeNew, good, fair, poor), categoryId, and brandId.itemId, url, title, price, currency (always USD), originalPrice, condition, conditionId, status, imageUrl, thumbnailUrl, sellerId, brand, categoryId, categoryName, and marketplace (always "mercari"). Each page costs 1 quota slot.X-Credit-Source: credits request header to use credits exclusively.X-eBay-Cookies request header on all scrape endpoints. Forward your own eBay session cookies to access login-gated results (e.g. adult categories, certain completed listings). Cookies are used only to run your requests. Use cookies from the same eBay site you are scraping — e.g. an ebay.co.uk request needs cookies from a UK eBay account.count parameter range is now 1–200 (previously 1–240). Requests that previously specified count=240 will return up to 200 items. No action needed — existing integrations continue to work; they may just receive slightly fewer items per page.exactMatch query parameter (default true) on all scrape endpoints. When true, eBay's loosened-match results ("Results matching fewer words") are stripped so only items closely matching your keyword are returned. Set to false to include all results eBay returns — useful when you want maximum volume over keyword precision.aspectFilter query parameter on /v1/scrape, /v1/scrape/category, /v1/scrape/max, the RapidAPI channel, and bulk search. Pass a JSON object of eBay item-aspect facet filters using the human-readable names from eBay's sidebar refinements (e.g. {"Brand":"Apple","Storage Capacity":"256 GB"}). Multi-select values use pipe as separator: {"Network":"Unlocked|AT&T"}. Facet names are dynamic per eBay category and vary by site language. Invalid or unrecognized facets are silently ignored by eBay.GET /v1/poshmark/sold endpoint — search Poshmark sold listings by keyword, with filters for department, condition, brand, price range, and sort order. Returns up to 48 items per page (Poshmark's native page size). Same auth and middleware stack as the eBay endpoints.enrich=true parameter fetches detailed data for each listing: soldAt, listedAt, daysToSell, category, condition, colors, description, shippingCost, commentsCount, shareCount, sellerLocation, sellerSoldCount, and sellerAvgShipTime. Enriched requests cost 2 quota slots instead of 1.totalResults response field on all scrape endpoints. Returns eBay's reported total result count for your search query as a string (e.g. "14,000+" or "89"). Approximate counts include a + suffix. null when unavailable. Distinct from totalItems (items returned on this page) and scrapedCount (items parsed before date filtering).soldAfter and soldBefore (both YYYY-MM-DD) on /v1/scrape, /v1/scrape/category, the RapidAPI channel, and bulk search. Filter sold results by endedAt — inclusive on both bounds. Sold-only; silently ignored when sold=false. This is a post-parse filter: each request still scrapes one full page from eBay, then filters, so a page may return fewer items than count.scrapedCount — the total items parsed from eBay before date filtering. Only present when soldAfter or soldBefore is set. If scrapedCount is high but items is low, more pages likely won't help.buyingFormat (default "all") on /v1/scrape, /v1/scrape/category, /v1/scrape/max, the RapidAPI channel, and bulk search. Filters results by listing format: "auction", "buyItNow" (fixed-price / Buy It Now), or "acceptsOffers" (listings with Best Offer enabled). This is an input filter, separate from the existing per-item buyingFormat field on each item in the response.categoryId field on each item in scrape responses is now deprecated. It echoed back the input categoryId filter parameter — not the item's actual eBay category. When no category filter was applied, it now returns null instead of "0". Use the response-level autoSelectedCategory for the best available category signal.endedAt on sold-listing responses now returns a date-only string (e.g. "2026-07-19") instead of a full ISO 8601 datetime with a fabricated midnight-UTC time. eBay's search results only ever expose a sold date, never a time of day, so the previous timestamp implied precision that doesn't exist. Non-breaking for any code parsing the value via new Date(...) — it resolves to the exact same instant.sold (default true) on /v1/scrape. Pass sold=false to return active, currently-listed items instead of completed sales. Each item carries listingType="active" and its own set of fields.currentPrice / currentPriceMax / currentCurrency (the asking price and its high bound for a multi-variant range), watcherCount (demand), unitsSold (velocity), acceptsOffers (Best Offer status), and timeLeft (raw auction countdown, e.g. "6d 4h"). All parsed across every supported eBay site.soldPrice, soldCurrency, endedAt, and bestOfferAccepted. Active responses omit those and use currentPrice/currentCurrency plus the new active signals instead.includeCompleteListing (default true) on all scrape endpoints. Adds LH_Complete=1 to the eBay search — the only way eBay renders the explicit "Best offer accepted" text on items where an offer was actually accepted. Without it, bestOfferAccepted was false for nearly all items.bestOfferAccepted is now accurate by default — existing integrations get the improvement automatically with no code change. Pass includeCompleteListing=false to restore the previous behavior.itemLocation: the seller's country as shown on the eBay search results page. Localized per site language (e.g. "United States" on ebay.com, "Großbritannien" on ebay.de). null on ebay.co.uk (which does not display location). No extra requests — the data was already on the page.buyingFormat field on each listing: "auction", "buy_it_now", or null. Lets you separate auction results from fixed-price sales without parsing the title.bidCount field: number of bids on auction listings. null for fixed-price and Best Offer listings.GET /v1/scrape/category endpoint: pass a categoryId and get sold listings for the entire category, no keyword required. Useful for tracking hardware, collectibles, or any niche where you want everything sold in a category./v1/scrape — ebaySite, page, count, sortOrder, minPrice, maxPrice, itemLocation, itemCondition, and sellerType on EU sites.fullResThumbnailUrl field on each listing — same image as thumbnailUrl but at 1600px instead of 500px. Derived automatically; no extra requests.POST /v1/scrape/max endpoint: submit a keyword once, get back all pages automatically. No more client-side loops, retry logic, or quota math.GET /v1/scrape/max/results/:jobId for inline JSON, download a signed CSV URL, or receive an email with the CSV attached./v1/scrape), so a 50-page sweep costs 50 requests. Failed pages don't count.DELETE /v1/scrape/max/:jobId cancels a running sweep between pages.500 response are now retried internally and return results normally.thumbnailUrl field on each listing — direct link to the eBay CDN image at 500px. Swap the suffix (s-l500 → s-l1600) for full resolution.sellerType field (private | business | null) on EU listings (ebay.de, ebay.fr, ebay.it, ebay.es). Always null on non-EU sites where eBay doesn't surface this.sellerType filter on /v1/scrape for EU sites — pass sellerType=private or sellerType=business to narrow results.condition field: the localized condition label exactly as eBay shows it (e.g. "Pre-Owned", "Neu", "Occasion"). Useful for filtering and display without post-processing.conditionId field: eBay's numeric condition code (1000 = New, 3000 = Used/Pre-Owned, 7000 = For Parts, etc.) derived from the label. null for unknown or unlisted labels.url field on each listing now returns a clean https://www.{ebaySite}/itm/{itemId}?nordt=true link. Previously, items with an ePID catalog match would silently redirect to the product catalog page. The nordt=true parameter bypasses this redirect on all 8 eBay sites.itmmeta, itmprp, hash, _skw, amdata) are no longer included in listing URLs.epid field on each listing: eBay's catalog product ID when the listing is matched to a specific product (e.g. iPhone 15 Pro 256GB). null when the seller hasn't matched their listing to a catalog entry.POST /api/bulk-search: submit up to 6 keywords in one request and get results for all of them concurrently via Server-Sent Events. Each keyword result streams as it completes.