Countdown API

Delete a Collection and every Request and Result Set in it. This cannot be undone.

Delete one Request from a Collection. Requests can only be deleted while the Collection is not running, and calls must be sequential: too many concurrent ones are answered 429. To remove them all, use the clear-requests tool instead. This cannot be undone.

Delete EVERY Request in a Collection, leaving the Collection itself in place. This cannot be undone.

Delete SEVERAL Destinations at once. The body is a JSON ARRAY of Destination id STRINGS. Collections that reference them stop uploading their Result Sets there. This cannot be undone.

Delete one Destination by id. Collections that reference it stop uploading their Result Sets there. This cannot be undone.

Retrieve the Countdown API account: plan, request credits used and remaining, the date the allowance resets, per-day usage history, Collection and Destination limits, the IP addresses Countdown API uploads to Destinations from, and the live parsing status of each request type. Free -- no request credits, which is why it is also the endpoint used to verify a pasted key. The account's own API key is REDACTED from the response by this integration.

List the Collections on the account, with search, status, date, destination, sorting and pagination filters. 25 per page by default, 1000 maximum. Rate limited to 60 calls a minute. Free -- no request credits.

Retrieve one Collection: its schedule, status, priority, destinations, and COUNTS of the Requests and Result Sets it holds. Use the list-requests and list-result-sets tools for the contents themselves. Free -- no request credits.

List one page of a Collection's Requests, 1000 per page, pages starting at 1 -- the Collection's requests_page_count says how many there are. Supply q to search the Requests and their custom_ids, or custom_id to match one exactly. Call sequentially; too many concurrent calls are answered 429. Free -- no request credits.

Retrieve download links for every Request in a Collection in CSV format, one link per page. Free -- no request credits.

Retrieve download links for every Request in a Collection in JSON format, one link per page. Free -- no request credits.

List every Result Set a Collection has produced, most recent first. Countdown API retains Result Sets for 14 days, so an older run's links are gone rather than broken. Free -- no request credits.

Retrieve one Result Set of a Collection as JSON: its details plus a download link per page of results. Free -- no request credits.

Retrieve one Result Set of a Collection as CSV: its details plus a download link per page. Supply csv_fields to choose the columns. Free -- no request credits.

Retrieve one Result Set of a Collection as JSON Lines: its details plus a download link per page. Free -- no request credits.

Ask Countdown API to re-send the webhook POST for one Result Set, which tests webhook connectivity without re-running the Collection. Free -- no request credits.

Start a Collection running now, whatever its schedule, as long as it is enabled and not already running. SPENDS REQUEST CREDITS: one per Request in the Collection, up to 15,000 in a single call, and the spend cannot be undone once the run begins. The account must hold enough credits for every Request or the start is refused.

Stop a Collection that is queued or running, returning it to idle. Free -- no request credits.

Stop EVERY Collection on the account that is queued or running, returning them all to idle. Account-wide: it stops Collections this connection did not start. Free -- no request credits.

List the Destinations on the account -- the S3, S3-compatible, Google Cloud Storage, Azure Blob Storage or Alibaba Cloud OSS buckets that Collection Result Sets are uploaded to -- with the account's destination usage against its limit. Free -- no request credits.

List the account's Error Logs -- requests that failed, with the eBay URL attempted, the API request that caused it (with the API key stripped by Countdown API), a count and the response given. 10 per page. The vendor states this API is free of charge and rate limited to 60 calls a minute, shared with the dashboard.

Retrieve eBay's own autocomplete suggestions for a partial search term. Both ebay_domain and search_term are REQUIRED, and this type accepts no other parameters of its own. Costs 1 request credit.

Retrieve the listings on an eBay deals page. url is REQUIRED and must be a deals page such as https://www.ebay.com/deals; this type takes no ebay_domain. Costs 1 request credit per page.

Retrieve one eBay product's details -- title, condition, offer and pricing, seller, shipping, returns policy, stock status and promotions. Identify it with epid (plus ebay_domain), with a GTIN/ISBN/UPC/EAN in gtin, or with a full eBay product-page url (which overrides ebay_domain and epid). Costs 1 request credit, or 2 when skip_gtin_cache or include_parts_compatibility is true.

Retrieve customer reviews for one eBay product, with condition and search filters, sorting and pagination. Identify the product with epid (plus ebay_domain), with a GTIN/ISBN/UPC/EAN in gtin, or with a full eBay product-page url. Costs 1 request credit per page.

Search an eBay domain for listings by search term, with category, listing-type, condition, sorting, facet and attribute filters and pagination. Supply search_term, or a full eBay search-results url (which overrides search_term, sort_by, listing_type, condition and page). Costs 1 request credit per page retrieved.

Retrieve the feedback an eBay seller has received or left, with rating, time-period and search filters and pagination. Identify the seller with seller_name (plus ebay_domain) or with a full eBay seller feedback url. Costs 1 request credit per page.

Retrieve an eBay seller's profile -- feedback score, ratings breakdown, member-since date and location. Identify the seller with seller_name (plus ebay_domain) or with a full eBay seller profile url. Seller names are returned by the product and reviews tools. Costs 1 request credit. MEASURED 2026-09-18: Countdown API answered this type 500 "unable to fulfil your request at this time" for two different sellers; the vendor does not charge for that failure, and the other six types were unaffected.

Create a Collection: a set of up to 15,000 eBay Product Data Requests that run together on a schedule, or on demand. An account may hold up to 10,000 Collections. Creating one is free; RUNNING one spends one request credit per Request in it.

Create a Destination that Collection Result Sets are uploaded to. Creating it ENABLED makes Countdown API upload and delete a test file to prove connectivity, and the create fails if that fails. The storage credentials in the body belong to the customer's own cloud account. Free -- no request credits.

Update a Collection's fields AND/OR add Requests to it -- Countdown API serves both from this one endpoint. Send the Collection's own fields to update it, or a `requests` array (up to 1000 per call) to add Requests. Requests can only be added or changed while the Collection is not running, and calls must be made sequentially: too many concurrent ones are answered 429. Free -- no request credits.

Update one Request inside a Collection. The body is a whole eBay Product Data request -- send type and that type's own parameters, not just the field being changed; measured 2026-09-18, omitting ebay_domain is refused 400 even when the stored Request already had one. Requests can only be updated while the Collection is not running, and calls must be sequential: too many concurrent ones are answered 429. Free -- no request credits.

Update a Destination. Takes the same fields as creating one. Enabling a disabled Destination, or changing its credentials, re-runs the connectivity test, and the update fails if that fails. Free -- no request credits.