The Countdown API connector lets your AI agent act in each user's Countdown API account. Each user connects their own Countdown API API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 30 tools.
- Tools
- 30
- What they doRead · write · destructive
- 11 · 15 · 411 read15 write4 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Countdown API connection
In AgentKit > Connections, create a Countdown API connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'countdown'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Countdown API:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'countdown_account_get',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "countdown"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Countdown API:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="countdown_account_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Countdown API credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolcountdown_account_getGet Countdown API account usage and platform status.Read-onlyGet Account
Get Countdown API account usage and platform status. Free: it uses no credits. Returns account_info (plan, credits used and remaining this month, overage) and platform status. Use it to check the API key and remaining credits.
Inputs
This tool takes no inputs.
countdown_collection_getGet one Countdown API collection.Read-onlyGet Collection
Get one Countdown API collection. Returns the collection: name, status (idle, queued, running), schedule, priority, notification settings, requests_count, requests_page_count and last run. Check status before adding or updating requests; they can only change while the collection is not running.
Inputs
collection_idstringrequired- ID of the collection. Find it with countdown_collections_list. Example: 123456.
countdown_collection_requests_exportGet a download link for all requests in a Countdown API collection as JSON or CSV.Read-onlyExport Collection Requests
Get a download link for all requests in a Countdown API collection as JSON or CSV. Returns request_info and a download link for the file. Use countdown_collection_requests_list to read requests page by page instead.
Inputs
collection_idstringrequired- ID of the collection. Find it with countdown_collections_list. Example: 123456.
formatstringrequired- File format: json or csv.one of
jsoncsv
countdown_collection_requests_findFind requests in a Countdown API collection by text in their parameters or by custom_id.Read-onlyFind Collection Requests
Find requests in a Countdown API collection by text in their parameters or by custom_id. Returns matching requests[] (id, custom_id, type and parameters). Use countdown_collection_request_update or countdown_collection_request_delete on a match.
Inputs
collection_idstringrequired- ID of the collection. Find it with countdown_collections_list. Example: 123456.
custom_idstring- Find the request with this custom_id. Example: MyCustomID_001.
pageinteger- Page of matches, starting at 1. Example: 1.default
1 qstring- Text to search for in the request parameters. Example: memory cards.
countdown_collection_requests_listList the requests in a Countdown API collection, 1,000 per page.Read-onlyList Collection Requests
List the requests in a Countdown API collection, 1,000 per page. Returns requests[] (id, custom_id, type and its parameters) for the page. Use countdown_collection_requests_find to search by text or custom_id.
Inputs
collection_idstringrequired- ID of the collection. Find it with countdown_collections_list. Example: 123456.
pageinteger- Page of requests, starting at 1 (see requests_page_count from countdown_collection_get). Example: 1.default
1
countdown_collection_result_exportGet a single-file download link for a Countdown API result set in JSON Lines or CSV format.Read-onlyExport Result Set
Get a single-file download link for a Countdown API result set in JSON Lines or CSV format. Returns result details and the download link for the file. Use countdown_collection_result_get for paged JSON links.
Inputs
collection_idstringrequired- ID of the collection. Find it with countdown_collections_list. Example: 123456.
formatstringrequired- File format: jsonlines or csv.one of
jsonlinescsv result_set_idstringrequired- ID of the result set. Example: 1.
countdown_collection_result_getGet one result set of a Countdown API collection with JSON download links for its result pages.Read-onlyGet Result Set
Get one result set of a Countdown API collection with JSON download links for its result pages. Returns result (id, run times, request and credit counts) and download_links for each page of JSON results. Use countdown_collection_results_list to find the result set ID; use countdown_collection_result_export for one JSON Lines or CSV file.
Inputs
collection_idstringrequired- ID of the collection. Find it with countdown_collections_list. Example: 123456.
result_set_idstringrequired- ID of the result set. Example: 1.
countdown_collection_results_listList the result sets of a Countdown API collection (kept for 14 days).Read-onlyList Result Sets
List the result sets of a Countdown API collection (kept for 14 days). Returns results[] (id, started_at, ended_at, requests_completed, credits_used) for each run. Use countdown_collection_result_get for the download links of one result set.
Inputs
collection_idstringrequired- ID of the collection. Find it with countdown_collections_list. Example: 123456.
countdown_collections_listList the batch-request collections in the Countdown API account, with search, status and date filters.Read-onlyList Collections
List the batch-request collections in the Countdown API account, with search, status and date filters. Returns collections[] (id, name, status, schedule, requests_count, last_run) and paging totals. Use countdown_collection_get for one collection.
Inputs
created_afterstring- Created after this ISO UTC time. Example: 2026-06-01T00:00:00.000Z.
created_beforestring- Created before this ISO UTC time. Example: 2026-09-01T00:00:00.000Z.
destination_idstring- Only collections that upload to this destination ID. Example: ABCDEFG.
last_run_afterstring- Last run after this ISO UTC time. Example: 2026-06-01T00:00:00.000Z.
last_run_beforestring- Last run before this ISO UTC time. Example: 2026-09-01T00:00:00.000Z.
only_with_resultsboolean- true returns only collections that have result sets.
only_without_resultsboolean- true returns only collections that have never produced results.
pageinteger- Page number, starting at 1. Example: 1.
page_sizeinteger- Collections per page (default 25, max 1000). Example: 100.
search_termstring- Only collections whose name contains this text. Example: prices.
search_typestring- How search_term matches: contains, starts_with, ends_with or exact.one of
containsstarts_withends_withexact sort_bystring- Sort by created_at, last_run, name (default), priority or status.one of
created_atlast_runnameprioritystatus sort_directionstring- ascending (default) or descending.one of
ascendingdescending statusstring- Only collections with this status: all (default), idle, queued or running.one of
allidlequeuedrunning
countdown_destinations_listList the cloud storage destinations (S3, GCS, Azure, OSS) that collections can upload results to.Read-onlyList Destinations
List the cloud storage destinations (S3, GCS, Azure, OSS) that collections can upload results to. Returns destinations[] with id, name, type and enabled, 10 per page. Use the id in destination_ids on countdown_collection_create or countdown_collection_update.
Inputs
pageinteger- Page number, starting at 1. Example: 1.
search_termstring- Only destinations whose name contains this text. Example: s3.
sort_bystring- Sort by type or name.one of
typename sort_directionstring- ascending (default) or descending.one of
ascendingdescending
countdown_error_logs_listList Countdown API error logs: requests that failed, grouped by parameters.Read-onlyList Error Logs
List Countdown API error logs: requests that failed, grouped by parameters. Returns logs[] (id, engine_url, api_url, date, count, parameters) and paging totals, 10 per page. Use to diagnose failing searches or collections.
Inputs
pageinteger- Page number, starting at 1. Example: 1.
search_termstring- Only logs whose parameters contain this text. Example: ebay.de.
sort_bystring- Sort by date or count.one of
datecount sort_directionstring- ascending (default) or descending.one of
ascendingdescending
countdown_autocomplete_getGet eBay's search autocomplete suggestions for a term on one eBay site.WriteGet eBay Autocomplete
Get eBay's search autocomplete suggestions for a term on one eBay site. Each call costs Countdown API credits. Returns autocomplete_results[] of suggested search terms. Use countdown_search to run a suggested search.
- Idempotent
Inputs
ebay_domainstringrequired- eBay site to query, e.g. ebay.com, ebay.co.uk or ebay.de.one of
ebay.comebay.co.ukebay.deebay.frebay.itebay.esebay.caebay.com.auebay.atebay.beebay.chebay.ieebay.nlebay.plebay.com.hkebay.com.myebay.com.sg search_termstringrequired- Partial search term to complete. Example: memory c.
customer_locationstring- Country to view eBay from, which changes shipping prices and availability, as a lowercase country code from Countdown's Customer Locations reference. Defaults to the eBay site's own country. Example: us.
customer_zipcodestring- Zip or postal code to view eBay from; only some customer_location values support it. Example: 10001.
exclude_fieldsstring- Comma-separated JSON fields (dot notation) to remove from the response. Example: request_metadata.
include_fieldsstring- Comma-separated JSON fields (dot notation) to keep in the response, dropping everything else. Example: search_results,pagination.
countdown_collection_createCreate a Countdown API collection: a saved batch of up to 15,000 eBay requests run on a schedule or on demand.WriteCreate Collection
Create a Countdown API collection: a saved batch of up to 15,000 eBay requests run on a schedule or on demand. Returns the new collection with its id. Next add requests with countdown_collection_requests_add, then run it with countdown_collection_start or wait for its schedule.
Inputs
namestringrequired- Name of the collection. Example: Daily memory card prices.
destination_idsarray- IDs of cloud storage destinations to upload result sets to (from countdown_destinations_list). Example: ["ABCDEFG"].
enabledboolean- Whether the collection runs on its schedule. Disabled collections only run when started.
notification_as_csvboolean- Include CSV download links in notifications (and upload CSV to destinations).
notification_as_jsonboolean- Include JSON download links in notifications (and upload JSON to destinations).
notification_as_jsonlinesboolean- Include JSON Lines download links in notifications (and upload JSON Lines to destinations).
notification_csv_fieldsstring- Comma-separated fields (dot notation) for CSV result sets. Example: search_results.title,search_results.price.value.
notification_emailstring- Email address notified when a new result set is ready. Example: data@example.com.
notification_webhookstring- URL that gets a POST when a new result set is ready. Example: https://example.com/countdown.
prioritystring- Queue priority among your collections: highest, high, normal, low or lowest.one of
highesthighnormallowlowest requests_typestring- Lock the collection to one request type, or mixed (default). Cannot be changed later.one of
mixedsearchproductreviewsseller_profileseller_feedbackautocompletedeals schedule_days_of_montharray- Days of the month to run on for monthly or minutes schedules. Example: [1, 15].
schedule_days_of_weekarray- Days of the week to run on (0 = Sunday to 6 = Saturday) for weekly or minutes schedules. Example: [1, 3].
schedule_hoursarray- Hours of the day (0-23, in your profile's timezone) to run on, for daily, weekly, monthly or minutes schedules. Example: [9, 17].
schedule_minutesstring- Run frequency when schedule_type is minutes.one of
every_minuteevery_5_minutesevery_10_minutesevery_15_minutesevery_20_minutesevery_25_minutesevery_30_minutesevery_hour schedule_typestring- How the collection is scheduled: manual (start it yourself), minutes, daily, weekly or monthly.one of
manualminutesdailyweeklymonthly
countdown_collection_request_updateChange the parameters of one request in a Countdown API collection that is not running.WriteUpdate Collection Request
Change the parameters of one request in a Countdown API collection that is not running. Only the fields you send change. Returns the updated request. Use countdown_collection_requests_find to get the request ID.
- Idempotent
Inputs
collection_idstringrequired- ID of the collection. Find it with countdown_collections_list. Example: 123456.
request_idstringrequired- ID of the request within the collection. Example: ABCDEFGHIJKLMNOP.
custom_idstring- Your own ID for the request. Example: MyCustomID_001.
ebay_domainstring- eBay site, e.g. ebay.com.one of
ebay.comebay.co.ukebay.deebay.frebay.itebay.esebay.caebay.com.auebay.atebay.beebay.chebay.ieebay.nlebay.plebay.com.hkebay.com.myebay.com.sg epidstring- eBay product ID. Example: 233599133856.
parametersobject- Any other request parameters to set, as name/value pairs (for example sort_by, condition, page, seller_name). Example: {"sort_by": "newly_listed"}.
search_termstring- Search keywords. Example: memory cards.
typestring- Request type.one of
searchproductreviewsseller_profileseller_feedbackautocompletedeals urlstring- eBay page URL to fetch. Example: https://www.ebay.com/itm/233599133856.
countdown_collection_requests_addAdd up to 1,000 eBay requests to a Countdown API collection that is not running (max 15,000 per collection, or 100 with include_html).WriteAdd Collection Requests
Add up to 1,000 eBay requests to a Countdown API collection that is not running (max 15,000 per collection, or 100 with include_html). Returns the collection with its new requests_count. Call it sequentially, not in parallel; use countdown_collection_requests_list to see what was added.
Inputs
collection_idstringrequired- ID of the collection. Find it with countdown_collections_list. Example: 123456.
requestsarrayrequired- Request objects using the same parameters as the search, product, reviews, seller and deals tools, each with a type and optionally your own custom_id. Example: [{"type": "product", "ebay_domain": "ebay.com", "epid": "233599133856", "custom_id": "MyCustomID_001"}].
countdown_collection_result_webhook_resendSend the result-set webhook of a Countdown API collection again to its notification_webhook URL.WriteResend Result Set Webhook
Send the result-set webhook of a Countdown API collection again to its notification_webhook URL. Returns request_info.success. Use when your webhook endpoint missed a delivery.
Inputs
collection_idstringrequired- ID of the collection. Find it with countdown_collections_list. Example: 123456.
result_set_idstringrequired- ID of the result set. Example: 1.
countdown_collection_startStart running a Countdown API collection now.WriteStart Collection
Start running a Countdown API collection now. Each request in it costs credits. Returns request_info.success; the collection status becomes queued or running. Poll countdown_collection_get for status, then read results with countdown_collection_results_list.
Inputs
collection_idstringrequired- ID of the collection. Find it with countdown_collections_list. Example: 123456.
countdown_collection_stopStop a running Countdown API collection.WriteStop Collection
Stop a running Countdown API collection. Requests already completed keep their results. Returns request_info.success. Use countdown_collections_stop_all to stop every collection.
- Idempotent
Inputs
collection_idstringrequired- ID of the collection. Find it with countdown_collections_list. Example: 123456.
countdown_collection_updateChange a Countdown API collection's name, schedule, priority, destinations or notification settings.WriteUpdate Collection
Change a Countdown API collection's name, schedule, priority, destinations or notification settings. Only the fields you send change. Returns the updated collection. Use countdown_collection_requests_add to add requests to it.
- Idempotent
Inputs
collection_idstringrequired- ID of the collection. Find it with countdown_collections_list. Example: 123456.
destination_idsarray- IDs of cloud storage destinations to upload result sets to (from countdown_destinations_list). Example: ["ABCDEFG"].
enabledboolean- Whether the collection runs on its schedule. Disabled collections only run when started.
namestring- Name of the collection. Example: Daily memory card prices.
notification_as_csvboolean- Include CSV download links in notifications (and upload CSV to destinations).
notification_as_jsonboolean- Include JSON download links in notifications (and upload JSON to destinations).
notification_as_jsonlinesboolean- Include JSON Lines download links in notifications (and upload JSON Lines to destinations).
notification_csv_fieldsstring- Comma-separated fields (dot notation) for CSV result sets. Example: search_results.title,search_results.price.value.
notification_emailstring- Email address notified when a new result set is ready. Example: data@example.com.
notification_webhookstring- URL that gets a POST when a new result set is ready. Example: https://example.com/countdown.
prioritystring- Queue priority among your collections: highest, high, normal, low or lowest.one of
highesthighnormallowlowest schedule_days_of_montharray- Days of the month to run on for monthly or minutes schedules. Example: [1, 15].
schedule_days_of_weekarray- Days of the week to run on (0 = Sunday to 6 = Saturday) for weekly or minutes schedules. Example: [1, 3].
schedule_hoursarray- Hours of the day (0-23, in your profile's timezone) to run on, for daily, weekly, monthly or minutes schedules. Example: [9, 17].
schedule_minutesstring- Run frequency when schedule_type is minutes.one of
every_minuteevery_5_minutesevery_10_minutesevery_15_minutesevery_20_minutesevery_25_minutesevery_30_minutesevery_hour schedule_typestring- How the collection is scheduled: manual (start it yourself), minutes, daily, weekly or monthly.one of
manualminutesdailyweeklymonthly
countdown_collections_stop_allStop every queued or running Countdown API collection in the account.WriteStop All Collections
Stop every queued or running Countdown API collection in the account. Returns request_info.success. Use countdown_collection_stop for a single collection.
- Idempotent
Inputs
This tool takes no inputs.
countdown_deals_getGet the listings on an eBay deals page.WriteGet eBay Deals
Get the listings on an eBay deals page. Each call costs Countdown API credits. Returns deals_results[] (title, epid, link, price, was price, discount) and pagination. Use countdown_search for keyword searches.
- Idempotent
Inputs
urlstringrequired- eBay deals page URL. Example: https://www.ebay.com/deals.
customer_locationstring- Country to view eBay from, which changes shipping prices and availability, as a lowercase country code from Countdown's Customer Locations reference. Defaults to the eBay site's own country. Example: us.
customer_zipcodestring- Zip or postal code to view eBay from; only some customer_location values support it. Example: 10001.
exclude_fieldsstring- Comma-separated JSON fields (dot notation) to remove from the response. Example: request_metadata.
include_fieldsstring- Comma-separated JSON fields (dot notation) to keep in the response, dropping everything else. Example: search_results,pagination.
max_pageinteger- Fetch and concatenate pages from page up to this page in one call (each page costs a credit). Example: 3.
pageinteger- Page of results to fetch, starting at 1. Example: 2.
countdown_product_getGet full details of an eBay product by EPID, GTIN/UPC/EAN/ISBN or product URL.WriteGet eBay Product
Get full details of an eBay product by EPID, GTIN/UPC/EAN/ISBN or product URL. Each call costs Countdown API credits. Returns product (title, brand, images, specifications, price, condition, seller, shipping, variants) and optional parts_compatibility. Use countdown_search to find EPIDs and countdown_reviews_get for reviews.
- Idempotent
Inputs
customer_locationstring- Country to view eBay from, which changes shipping prices and availability, as a lowercase country code from Countdown's Customer Locations reference. Defaults to the eBay site's own country. Example: us.
customer_zipcodestring- Zip or postal code to view eBay from; only some customer_location values support it. Example: 10001.
ebay_domainstring- eBay site to query, e.g. ebay.com, ebay.co.uk or ebay.de.one of
ebay.comebay.co.ukebay.deebay.frebay.itebay.esebay.caebay.com.auebay.atebay.beebay.chebay.ieebay.nlebay.plebay.com.hkebay.com.myebay.com.sg epidstring- eBay product ID (EPID); use with ebay_domain. Example: 233599133856.
exclude_fieldsstring- Comma-separated JSON fields (dot notation) to remove from the response. Example: request_metadata.
gtinstring- GTIN, ISBN, UPC or EAN to look up instead of an EPID; use with ebay_domain. Example: 0889842640816.
include_fieldsstring- Comma-separated JSON fields (dot notation) to keep in the response, dropping everything else. Example: search_results,pagination.
include_htmlboolean- Include the raw page HTML in the response (large).
include_parts_compatibilityboolean- Also return the parts compatibility table (costs 2 credits instead of 1).
skip_gtin_cacheboolean- true forces a fresh GTIN-to-EPID lookup (costs 2 credits instead of 1).
urlstring- eBay product page URL, used when no epid or gtin is given. Example: https://www.ebay.com/itm/233599133856.
countdown_reviews_getGet customer reviews of an eBay product by EPID, GTIN or product URL, optionally filtered and sorted.WriteGet eBay Reviews
Get customer reviews of an eBay product by EPID, GTIN or product URL, optionally filtered and sorted. Each call costs Countdown API credits. Returns reviews[] (title, body, rating, date, author, verified purchase), a summary and pagination. Use countdown_product_get for the product details.
- Idempotent
Inputs
conditionstring- Only reviews of products in this condition: all, new, refurbished or preowned.one of
allnewrefurbishedpreowned customer_locationstring- Country to view eBay from, which changes shipping prices and availability, as a lowercase country code from Countdown's Customer Locations reference. Defaults to the eBay site's own country. Example: us.
customer_zipcodestring- Zip or postal code to view eBay from; only some customer_location values support it. Example: 10001.
ebay_domainstring- eBay site to query, e.g. ebay.com, ebay.co.uk or ebay.de.one of
ebay.comebay.co.ukebay.deebay.frebay.itebay.esebay.caebay.com.auebay.atebay.beebay.chebay.ieebay.nlebay.plebay.com.hkebay.com.myebay.com.sg epidstring- eBay product ID (EPID); use with ebay_domain. Example: 233599133856.
exclude_fieldsstring- Comma-separated JSON fields (dot notation) to remove from the response. Example: request_metadata.
gtinstring- GTIN, ISBN, UPC or EAN to look up instead of an EPID; use with ebay_domain. Example: 0889842640816.
include_fieldsstring- Comma-separated JSON fields (dot notation) to keep in the response, dropping everything else. Example: search_results,pagination.
max_pageinteger- Fetch and concatenate pages from page up to this page in one call (each page costs a credit). Example: 3.
pageinteger- Page of results to fetch, starting at 1. Example: 2.
search_termstring- Only reviews containing this text. Example: battery.
skip_gtin_cacheboolean- true forces a fresh GTIN-to-EPID lookup (costs 2 credits instead of 1).
sort_bystring- Sort order: most_relevant, most_recent, rating_high_to_low or rating_low_to_high.one of
most_relevantmost_recentrating_high_to_lowrating_low_to_high urlstring- eBay product page URL, used when no epid or gtin is given. Example: https://www.ebay.com/p/233599133856.
countdown_searchSearch eBay listings by keyword or search-page URL, with filters for condition, listing type, category and seller options.WriteSearch eBay
Search eBay listings by keyword or search-page URL, with filters for condition, listing type, category and seller options. Each call costs Countdown API credits. Returns search_results[] (title, epid, link, price, condition, seller, shipping) and pagination. Use countdown_product_get for one product and countdown_autocomplete_get for keyword ideas.
- Idempotent
Inputs
allow_rewritten_resultsboolean- false drops results listed under eBay's 'Results matching fewer words' banner (default true).
authenticity_verifiedboolean- Only authenticity-verified items.
authorized_sellersboolean- Only items from authorized sellers.
category_idstring- eBay category ID (the _sacat value in eBay search URLs). Example: 96991.
conditionstring- Item condition: all, new, used, open_box, manufacturer_refurbished, seller_refurbished, parts_or_not_working or not_specified.one of
allnewusedopen_boxmanufacturer_refurbishedseller_refurbishedparts_or_not_workingnot_specified customer_locationstring- Country to view eBay from, which changes shipping prices and availability, as a lowercase country code from Countdown's Customer Locations reference. Defaults to the eBay site's own country. Example: us.
customer_zipcodestring- Zip or postal code to view eBay from; only some customer_location values support it. Example: 10001.
deals_and_savingsboolean- Only deals and savings items.
ebay_domainstring- eBay site to query, e.g. ebay.com, ebay.co.uk or ebay.de.one of
ebay.comebay.co.ukebay.deebay.frebay.itebay.esebay.caebay.com.auebay.atebay.beebay.chebay.ieebay.nlebay.plebay.com.hkebay.com.myebay.com.sg exclude_fieldsstring- Comma-separated JSON fields (dot notation) to remove from the response. Example: request_metadata.
facetsstring- eBay filter facets as comma-separated name=value pairs, case-sensitive as in eBay URLs; separate several values of one facet with |. Example: Brand=SanDisk,Format=MicroSD.
free_returnsboolean- Only items with free returns.
include_fieldsstring- Comma-separated JSON fields (dot notation) to keep in the response, dropping everything else. Example: search_results,pagination.
listing_typestring- Listing format: all, buy_it_now, auction or accepts_offers.one of
allbuy_it_nowauctionaccepts_offers max_pageinteger- Fetch and concatenate pages from page up to this page in one call (each page costs a credit). Example: 3.
numinteger- Results per page requested from eBay: 60, 120 or 240.one of
60120240 pageinteger- Page of results to fetch, starting at 1. Example: 2.
returns_acceptedboolean- Only items that accept returns.
sale_itemsboolean- Only sale items.
search_termstring- Keywords to search for. Required unless url is given. Example: memory cards.
sort_bystring- Sort order: best_match, price_high_to_low, price_low_to_high, price_high_to_low_plus_postage, price_low_to_high_plus_postage, newly_listed or ending_soonest.one of
best_matchprice_high_to_lowprice_low_to_highprice_high_to_low_plus_postageprice_low_to_high_plus_postagenewly_listedending_soonest urlstring- eBay search results page URL to fetch instead; search_term, sort_by, listing_type, condition and page are then ignored. Example: https://www.ebay.com/sch/i.html?_nkw=memory+cards.
countdown_seller_feedback_getGet feedback left for or by an eBay seller, filtered by type, period and rating.WriteGet eBay Seller Feedback
Get feedback left for or by an eBay seller, filtered by type, period and rating. Each call costs Countdown API credits. Returns seller_feedback[] (rating, comment, item, date, buyer) and pagination. Use countdown_seller_profile_get for the seller's summary.
- Idempotent
Inputs
customer_locationstring- Country to view eBay from, which changes shipping prices and availability, as a lowercase country code from Countdown's Customer Locations reference. Defaults to the eBay site's own country. Example: us.
customer_zipcodestring- Zip or postal code to view eBay from; only some customer_location values support it. Example: 10001.
ebay_domainstring- eBay site to query, e.g. ebay.com, ebay.co.uk or ebay.de.one of
ebay.comebay.co.ukebay.deebay.frebay.itebay.esebay.caebay.com.auebay.atebay.beebay.chebay.ieebay.nlebay.plebay.com.hkebay.com.myebay.com.sg exclude_fieldsstring- Comma-separated JSON fields (dot notation) to remove from the response. Example: request_metadata.
include_fieldsstring- Comma-separated JSON fields (dot notation) to keep in the response, dropping everything else. Example: search_results,pagination.
max_pageinteger- Fetch and concatenate pages from page up to this page in one call (each page costs a credit). Example: 3.
numinteger- Feedback per page: 25, 50, 100 or 200.one of
2550100200 pageinteger- Page of results to fetch, starting at 1. Example: 2.
search_termstring- Only feedback containing this text; only with seller_feedback_type received_as_seller. Example: fast shipping.
seller_feedback_overall_ratingstring- Only positive, neutral or negative feedback; needs a time period other than all and not left_for_others.one of
positiveneutralnegative seller_feedback_time_periodstring- Period: all (default), one_month, six_months or twelve_months; only with received_as_buyer or received_as_seller.one of
allone_monthsix_monthstwelve_months seller_feedback_typestring- Which feedback: all, received_as_buyer, received_as_seller or left_for_others.one of
allreceived_as_buyerreceived_as_sellerleft_for_others seller_namestring- eBay seller user name; use with ebay_domain. Seller names come back from product and reviews results. Example: mobileking.
urlstring- eBay seller feedback page URL, used when no seller_name is given.
countdown_seller_profile_getGet an eBay seller's profile by seller name or profile URL.WriteGet eBay Seller Profile
Get an eBay seller's profile by seller name or profile URL. Each call costs Countdown API credits. Returns seller_details (name, feedback score, positive percentage, member since, location, store info). Use countdown_seller_feedback_get for the seller's individual feedback.
- Idempotent
Inputs
customer_locationstring- Country to view eBay from, which changes shipping prices and availability, as a lowercase country code from Countdown's Customer Locations reference. Defaults to the eBay site's own country. Example: us.
customer_zipcodestring- Zip or postal code to view eBay from; only some customer_location values support it. Example: 10001.
ebay_domainstring- eBay site to query, e.g. ebay.com, ebay.co.uk or ebay.de.one of
ebay.comebay.co.ukebay.deebay.frebay.itebay.esebay.caebay.com.auebay.atebay.beebay.chebay.ieebay.nlebay.plebay.com.hkebay.com.myebay.com.sg exclude_fieldsstring- Comma-separated JSON fields (dot notation) to remove from the response. Example: request_metadata.
include_fieldsstring- Comma-separated JSON fields (dot notation) to keep in the response, dropping everything else. Example: search_results,pagination.
is_storeboolean- true for an eBay storefront (uses the /str/ URL format instead of /usr/).
seller_namestring- eBay seller user name; use with ebay_domain. Seller names come back from product and reviews results. Example: mobileking.
urlstring- eBay seller profile URL, used when no seller_name is given. Example: https://www.ebay.com/usr/mobileking.
countdown_collection_deleteDelete a Countdown API collection with its requests and result sets.DestructiveDelete Collection
Delete a Countdown API collection with its requests and result sets. Returns request_info.success. Use countdown_collection_requests_clear to empty it but keep the collection.
- Idempotent
Inputs
collection_idstringrequired- ID of the collection. Find it with countdown_collections_list. Example: 123456.
countdown_collection_request_deleteRemove one request from a Countdown API collection that is not running.DestructiveDelete Collection Request
Remove one request from a Countdown API collection that is not running. Returns request_info.success. Use countdown_collection_requests_clear to remove all requests.
- Idempotent
Inputs
collection_idstringrequired- ID of the collection. Find it with countdown_collections_list. Example: 123456.
request_idstringrequired- ID of the request to delete. Example: ABCDEFGHIJKLMNOP.
countdown_collection_requests_clearRemove every request from a Countdown API collection, keeping the collection and its settings.DestructiveClear Collection Requests
Remove every request from a Countdown API collection, keeping the collection and its settings. Returns request_info.success. Use countdown_collection_delete to remove the collection too.
- Idempotent
Inputs
collection_idstringrequired- ID of the collection. Find it with countdown_collections_list. Example: 123456.
countdown_destination_deleteDelete a Countdown API cloud storage destination.DestructiveDelete Destination
Delete a Countdown API cloud storage destination. Collections stop uploading to it. Returns request_info.success. Use countdown_destinations_list to find the ID.
- Idempotent
Inputs
destination_idstringrequired- ID of the destination. Example: ABCDEFG.
No tools match.