> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Countdown API

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.

**Authentication:** API Key
**Categories:** Search, Analytics
**Tools:** 30: 11 read, 15 write, 4 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=COUNTDOWN)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Countdown API connection

   In **AgentKit > Connections**, create a Countdown API connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   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.actions

   const connector = 'countdown'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { 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 call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'countdown_account_get',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_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.actions

   connection_name = "countdown"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_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 call
   result = actions.execute_tool(
       tool_input={},
       tool_name="countdown_account_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Countdown API credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'countdown_account_get',
  toolInput: {},
  connector: 'countdown',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="countdown_account_get",
    tool_input={},
    connection_name="countdown",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `countdown_account_get`

Get Account · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `countdown_collection_get`

Get Collection · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`string`, required): ID of the collection. Find it with countdown_collections_list. Example: 123456.

Example input: `{"collection_id":"<collection_id>"}`

### `countdown_collection_requests_export`

Export Collection Requests · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`string`, required): ID of the collection. Find it with countdown_collections_list. Example: 123456.
- `format` (`string`, required): File format: json or csv. One of: `json`, `csv`.

Example input: `{"collection_id":"<collection_id>","format":"json"}`

### `countdown_collection_requests_find`

Find Collection Requests · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`string`, required): ID of the collection. Find it with countdown_collections_list. Example: 123456.
- `custom_id` (`string`, optional): Find the request with this custom_id. Example: MyCustomID_001.
- `page` (`integer`, optional): Page of matches, starting at 1. Example: 1. Default: `1`.
- `q` (`string`, optional): Text to search for in the request parameters. Example: memory cards.

Example input: `{"collection_id":"<collection_id>"}`

### `countdown_collection_requests_list`

List Collection Requests · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`string`, required): ID of the collection. Find it with countdown_collections_list. Example: 123456.
- `page` (`integer`, optional): Page of requests, starting at 1 (see requests_page_count from countdown_collection_get). Example: 1. Default: `1`.

Example input: `{"collection_id":"<collection_id>"}`

### `countdown_collection_result_export`

Export Result Set · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`string`, required): ID of the collection. Find it with countdown_collections_list. Example: 123456.
- `format` (`string`, required): File format: jsonlines or csv. One of: `jsonlines`, `csv`.
- `result_set_id` (`string`, required): ID of the result set. Example: 1.

Example input: `{"collection_id":"<collection_id>","format":"jsonlines","result_set_id":"<result_set_id>"}`

### `countdown_collection_result_get`

Get Result Set · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`string`, required): ID of the collection. Find it with countdown_collections_list. Example: 123456.
- `result_set_id` (`string`, required): ID of the result set. Example: 1.

Example input: `{"collection_id":"<collection_id>","result_set_id":"<result_set_id>"}`

### `countdown_collection_results_list`

List Result Sets · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`string`, required): ID of the collection. Find it with countdown_collections_list. Example: 123456.

Example input: `{"collection_id":"<collection_id>"}`

### `countdown_collections_list`

List Collections · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `created_after` (`string`, optional): Created after this ISO UTC time. Example: 2026-06-01T00:00:00.000Z.
- `created_before` (`string`, optional): Created before this ISO UTC time. Example: 2026-09-01T00:00:00.000Z.
- `destination_id` (`string`, optional): Only collections that upload to this destination ID. Example: ABCDEFG.
- `last_run_after` (`string`, optional): Last run after this ISO UTC time. Example: 2026-06-01T00:00:00.000Z.
- `last_run_before` (`string`, optional): Last run before this ISO UTC time. Example: 2026-09-01T00:00:00.000Z.
- `only_with_results` (`boolean`, optional): true returns only collections that have result sets.
- `only_without_results` (`boolean`, optional): true returns only collections that have never produced results.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Collections per page (default 25, max 1000). Example: 100.
- `search_term` (`string`, optional): Only collections whose name contains this text. Example: prices.
- `search_type` (`string`, optional): How search_term matches: contains, starts_with, ends_with or exact. One of: `contains`, `starts_with`, `ends_with`, `exact`.
- `sort_by` (`string`, optional): Sort by created_at, last_run, name (default), priority or status. One of: `created_at`, `last_run`, `name`, `priority`, `status`.
- `sort_direction` (`string`, optional): ascending (default) or descending. One of: `ascending`, `descending`.
- `status` (`string`, optional): Only collections with this status: all (default), idle, queued or running. One of: `all`, `idle`, `queued`, `running`.

Example input: `{}`

### `countdown_destinations_list`

List Destinations · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `search_term` (`string`, optional): Only destinations whose name contains this text. Example: s3.
- `sort_by` (`string`, optional): Sort by type or name. One of: `type`, `name`.
- `sort_direction` (`string`, optional): ascending (default) or descending. One of: `ascending`, `descending`.

Example input: `{}`

### `countdown_error_logs_list`

List Error Logs · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `search_term` (`string`, optional): Only logs whose parameters contain this text. Example: ebay.de.
- `sort_by` (`string`, optional): Sort by date or count. One of: `date`, `count`.
- `sort_direction` (`string`, optional): ascending (default) or descending. One of: `ascending`, `descending`.

Example input: `{}`

### `countdown_autocomplete_get`

Get eBay Autocomplete · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ebay_domain` (`string`, required): eBay site to query, e.g. ebay.com, ebay.co.uk or ebay.de. One of: `ebay.com`, `ebay.co.uk`, `ebay.de`, `ebay.fr`, `ebay.it`, `ebay.es`, `ebay.ca`, `ebay.com.au`, `ebay.at`, `ebay.be`, `ebay.ch`, `ebay.ie`, `ebay.nl`, `ebay.pl`, `ebay.com.hk`, `ebay.com.my`, `ebay.com.sg`.
- `search_term` (`string`, required): Partial search term to complete. Example: memory c.
- `customer_location` (`string`, optional): 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_zipcode` (`string`, optional): Zip or postal code to view eBay from; only some customer_location values support it. Example: 10001.
- `exclude_fields` (`string`, optional): Comma-separated JSON fields (dot notation) to remove from the response. Example: request_metadata.
- `include_fields` (`string`, optional): Comma-separated JSON fields (dot notation) to keep in the response, dropping everything else. Example: search_results,pagination.

Example input: `{"ebay_domain":"ebay.com","search_term":"<search_term>"}`

### `countdown_collection_create`

Create Collection · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Name of the collection. Example: Daily memory card prices.
- `destination_ids` (`array`, optional): IDs of cloud storage destinations to upload result sets to (from countdown_destinations_list). Example: ["ABCDEFG"].
- `enabled` (`boolean`, optional): Whether the collection runs on its schedule. Disabled collections only run when started.
- `notification_as_csv` (`boolean`, optional): Include CSV download links in notifications (and upload CSV to destinations).
- `notification_as_json` (`boolean`, optional): Include JSON download links in notifications (and upload JSON to destinations).
- `notification_as_jsonlines` (`boolean`, optional): Include JSON Lines download links in notifications (and upload JSON Lines to destinations).
- `notification_csv_fields` (`string`, optional): Comma-separated fields (dot notation) for CSV result sets. Example: search_results.title,search_results.price.value.
- `notification_email` (`string`, optional): Email address notified when a new result set is ready. Example: data@example.com.
- `notification_webhook` (`string`, optional): URL that gets a POST when a new result set is ready. Example: https://example.com/countdown.
- `priority` (`string`, optional): Queue priority among your collections: highest, high, normal, low or lowest. One of: `highest`, `high`, `normal`, `low`, `lowest`.
- `requests_type` (`string`, optional): Lock the collection to one request type, or mixed (default). Cannot be changed later. One of: `mixed`, `search`, `product`, `reviews`, `seller_profile`, `seller_feedback`, `autocomplete`, `deals`.
- `schedule_days_of_month` (`array`, optional): Days of the month to run on for monthly or minutes schedules. Example: [1, 15].
- `schedule_days_of_week` (`array`, optional): Days of the week to run on (0 = Sunday to 6 = Saturday) for weekly or minutes schedules. Example: [1, 3].
- `schedule_hours` (`array`, optional): 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_minutes` (`string`, optional): Run frequency when schedule_type is minutes. One of: `every_minute`, `every_5_minutes`, `every_10_minutes`, `every_15_minutes`, `every_20_minutes`, `every_25_minutes`, `every_30_minutes`, `every_hour`.
- `schedule_type` (`string`, optional): How the collection is scheduled: manual (start it yourself), minutes, daily, weekly or monthly. One of: `manual`, `minutes`, `daily`, `weekly`, `monthly`.

Example input: `{"name":"<name>"}`

### `countdown_collection_request_update`

Update Collection Request · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`string`, required): ID of the collection. Find it with countdown_collections_list. Example: 123456.
- `request_id` (`string`, required): ID of the request within the collection. Example: ABCDEFGHIJKLMNOP.
- `custom_id` (`string`, optional): Your own ID for the request. Example: MyCustomID_001.
- `ebay_domain` (`string`, optional): eBay site, e.g. ebay.com. One of: `ebay.com`, `ebay.co.uk`, `ebay.de`, `ebay.fr`, `ebay.it`, `ebay.es`, `ebay.ca`, `ebay.com.au`, `ebay.at`, `ebay.be`, `ebay.ch`, `ebay.ie`, `ebay.nl`, `ebay.pl`, `ebay.com.hk`, `ebay.com.my`, `ebay.com.sg`.
- `epid` (`string`, optional): eBay product ID. Example: 233599133856.
- `parameters` (`object`, optional): Any other request parameters to set, as name/value pairs (for example sort_by, condition, page, seller_name). Example: {"sort_by": "newly_listed"}.
- `search_term` (`string`, optional): Search keywords. Example: memory cards.
- `type` (`string`, optional): Request type. One of: `search`, `product`, `reviews`, `seller_profile`, `seller_feedback`, `autocomplete`, `deals`.
- `url` (`string`, optional): eBay page URL to fetch. Example: https://www.ebay.com/itm/233599133856.

Example input: `{"collection_id":"<collection_id>","request_id":"<request_id>"}`

### `countdown_collection_requests_add`

Add Collection Requests · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `collection_id` (`string`, required): ID of the collection. Find it with countdown_collections_list. Example: 123456.
- `requests` (`array`, required): 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"}].

Example input: `{"collection_id":"<collection_id>","requests":[{"type":"product","ebay_domain":"ebay.com","epid":"233599133856","custom_id":"MyCustomID_001"}]}`

### `countdown_collection_result_webhook_resend`

Resend Result Set Webhook · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `collection_id` (`string`, required): ID of the collection. Find it with countdown_collections_list. Example: 123456.
- `result_set_id` (`string`, required): ID of the result set. Example: 1.

Example input: `{"collection_id":"<collection_id>","result_set_id":"<result_set_id>"}`

### `countdown_collection_start`

Start Collection · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `collection_id` (`string`, required): ID of the collection. Find it with countdown_collections_list. Example: 123456.

Example input: `{"collection_id":"<collection_id>"}`

### `countdown_collection_stop`

Stop Collection · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`string`, required): ID of the collection. Find it with countdown_collections_list. Example: 123456.

Example input: `{"collection_id":"<collection_id>"}`

### `countdown_collection_update`

Update Collection · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`string`, required): ID of the collection. Find it with countdown_collections_list. Example: 123456.
- `destination_ids` (`array`, optional): IDs of cloud storage destinations to upload result sets to (from countdown_destinations_list). Example: ["ABCDEFG"].
- `enabled` (`boolean`, optional): Whether the collection runs on its schedule. Disabled collections only run when started.
- `name` (`string`, optional): Name of the collection. Example: Daily memory card prices.
- `notification_as_csv` (`boolean`, optional): Include CSV download links in notifications (and upload CSV to destinations).
- `notification_as_json` (`boolean`, optional): Include JSON download links in notifications (and upload JSON to destinations).
- `notification_as_jsonlines` (`boolean`, optional): Include JSON Lines download links in notifications (and upload JSON Lines to destinations).
- `notification_csv_fields` (`string`, optional): Comma-separated fields (dot notation) for CSV result sets. Example: search_results.title,search_results.price.value.
- `notification_email` (`string`, optional): Email address notified when a new result set is ready. Example: data@example.com.
- `notification_webhook` (`string`, optional): URL that gets a POST when a new result set is ready. Example: https://example.com/countdown.
- `priority` (`string`, optional): Queue priority among your collections: highest, high, normal, low or lowest. One of: `highest`, `high`, `normal`, `low`, `lowest`.
- `schedule_days_of_month` (`array`, optional): Days of the month to run on for monthly or minutes schedules. Example: [1, 15].
- `schedule_days_of_week` (`array`, optional): Days of the week to run on (0 = Sunday to 6 = Saturday) for weekly or minutes schedules. Example: [1, 3].
- `schedule_hours` (`array`, optional): 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_minutes` (`string`, optional): Run frequency when schedule_type is minutes. One of: `every_minute`, `every_5_minutes`, `every_10_minutes`, `every_15_minutes`, `every_20_minutes`, `every_25_minutes`, `every_30_minutes`, `every_hour`.
- `schedule_type` (`string`, optional): How the collection is scheduled: manual (start it yourself), minutes, daily, weekly or monthly. One of: `manual`, `minutes`, `daily`, `weekly`, `monthly`.

Example input: `{"collection_id":"<collection_id>"}`

### `countdown_collections_stop_all`

Stop All Collections · Write

Stop every queued or running Countdown API collection in the account.
Returns request_info.success.
Use countdown_collection_stop for a single collection.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `countdown_deals_get`

Get eBay Deals · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `url` (`string`, required): eBay deals page URL. Example: https://www.ebay.com/deals.
- `customer_location` (`string`, optional): 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_zipcode` (`string`, optional): Zip or postal code to view eBay from; only some customer_location values support it. Example: 10001.
- `exclude_fields` (`string`, optional): Comma-separated JSON fields (dot notation) to remove from the response. Example: request_metadata.
- `include_fields` (`string`, optional): Comma-separated JSON fields (dot notation) to keep in the response, dropping everything else. Example: search_results,pagination.
- `max_page` (`integer`, optional): Fetch and concatenate pages from page up to this page in one call (each page costs a credit). Example: 3.
- `page` (`integer`, optional): Page of results to fetch, starting at 1. Example: 2.

Example input: `{"url":"<url>"}`

### `countdown_product_get`

Get eBay Product · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `customer_location` (`string`, optional): 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_zipcode` (`string`, optional): Zip or postal code to view eBay from; only some customer_location values support it. Example: 10001.
- `ebay_domain` (`string`, optional): eBay site to query, e.g. ebay.com, ebay.co.uk or ebay.de. One of: `ebay.com`, `ebay.co.uk`, `ebay.de`, `ebay.fr`, `ebay.it`, `ebay.es`, `ebay.ca`, `ebay.com.au`, `ebay.at`, `ebay.be`, `ebay.ch`, `ebay.ie`, `ebay.nl`, `ebay.pl`, `ebay.com.hk`, `ebay.com.my`, `ebay.com.sg`.
- `epid` (`string`, optional): eBay product ID (EPID); use with ebay_domain. Example: 233599133856.
- `exclude_fields` (`string`, optional): Comma-separated JSON fields (dot notation) to remove from the response. Example: request_metadata.
- `gtin` (`string`, optional): GTIN, ISBN, UPC or EAN to look up instead of an EPID; use with ebay_domain. Example: 0889842640816.
- `include_fields` (`string`, optional): Comma-separated JSON fields (dot notation) to keep in the response, dropping everything else. Example: search_results,pagination.
- `include_html` (`boolean`, optional): Include the raw page HTML in the response (large).
- `include_parts_compatibility` (`boolean`, optional): Also return the parts compatibility table (costs 2 credits instead of 1).
- `skip_gtin_cache` (`boolean`, optional): true forces a fresh GTIN-to-EPID lookup (costs 2 credits instead of 1).
- `url` (`string`, optional): eBay product page URL, used when no epid or gtin is given. Example: https://www.ebay.com/itm/233599133856.

Example input: `{}`

### `countdown_reviews_get`

Get eBay Reviews · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `condition` (`string`, optional): Only reviews of products in this condition: all, new, refurbished or preowned. One of: `all`, `new`, `refurbished`, `preowned`.
- `customer_location` (`string`, optional): 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_zipcode` (`string`, optional): Zip or postal code to view eBay from; only some customer_location values support it. Example: 10001.
- `ebay_domain` (`string`, optional): eBay site to query, e.g. ebay.com, ebay.co.uk or ebay.de. One of: `ebay.com`, `ebay.co.uk`, `ebay.de`, `ebay.fr`, `ebay.it`, `ebay.es`, `ebay.ca`, `ebay.com.au`, `ebay.at`, `ebay.be`, `ebay.ch`, `ebay.ie`, `ebay.nl`, `ebay.pl`, `ebay.com.hk`, `ebay.com.my`, `ebay.com.sg`.
- `epid` (`string`, optional): eBay product ID (EPID); use with ebay_domain. Example: 233599133856.
- `exclude_fields` (`string`, optional): Comma-separated JSON fields (dot notation) to remove from the response. Example: request_metadata.
- `gtin` (`string`, optional): GTIN, ISBN, UPC or EAN to look up instead of an EPID; use with ebay_domain. Example: 0889842640816.
- `include_fields` (`string`, optional): Comma-separated JSON fields (dot notation) to keep in the response, dropping everything else. Example: search_results,pagination.
- `max_page` (`integer`, optional): Fetch and concatenate pages from page up to this page in one call (each page costs a credit). Example: 3.
- `page` (`integer`, optional): Page of results to fetch, starting at 1. Example: 2.
- `search_term` (`string`, optional): Only reviews containing this text. Example: battery.
- `skip_gtin_cache` (`boolean`, optional): true forces a fresh GTIN-to-EPID lookup (costs 2 credits instead of 1).
- `sort_by` (`string`, optional): Sort order: most_relevant, most_recent, rating_high_to_low or rating_low_to_high. One of: `most_relevant`, `most_recent`, `rating_high_to_low`, `rating_low_to_high`.
- `url` (`string`, optional): eBay product page URL, used when no epid or gtin is given. Example: https://www.ebay.com/p/233599133856.

Example input: `{}`

### `countdown_search`

Search eBay · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `allow_rewritten_results` (`boolean`, optional): false drops results listed under eBay's 'Results matching fewer words' banner (default true).
- `authenticity_verified` (`boolean`, optional): Only authenticity-verified items.
- `authorized_sellers` (`boolean`, optional): Only items from authorized sellers.
- `category_id` (`string`, optional): eBay category ID (the _sacat value in eBay search URLs). Example: 96991.
- `condition` (`string`, optional): Item condition: all, new, used, open_box, manufacturer_refurbished, seller_refurbished, parts_or_not_working or not_specified. One of: `all`, `new`, `used`, `open_box`, `manufacturer_refurbished`, `seller_refurbished`, `parts_or_not_working`, `not_specified`.
- `customer_location` (`string`, optional): 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_zipcode` (`string`, optional): Zip or postal code to view eBay from; only some customer_location values support it. Example: 10001.
- `deals_and_savings` (`boolean`, optional): Only deals and savings items.
- `ebay_domain` (`string`, optional): eBay site to query, e.g. ebay.com, ebay.co.uk or ebay.de. One of: `ebay.com`, `ebay.co.uk`, `ebay.de`, `ebay.fr`, `ebay.it`, `ebay.es`, `ebay.ca`, `ebay.com.au`, `ebay.at`, `ebay.be`, `ebay.ch`, `ebay.ie`, `ebay.nl`, `ebay.pl`, `ebay.com.hk`, `ebay.com.my`, `ebay.com.sg`.
- `exclude_fields` (`string`, optional): Comma-separated JSON fields (dot notation) to remove from the response. Example: request_metadata.
- `facets` (`string`, optional): 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_returns` (`boolean`, optional): Only items with free returns.
- `include_fields` (`string`, optional): Comma-separated JSON fields (dot notation) to keep in the response, dropping everything else. Example: search_results,pagination.
- `listing_type` (`string`, optional): Listing format: all, buy_it_now, auction or accepts_offers. One of: `all`, `buy_it_now`, `auction`, `accepts_offers`.
- `max_page` (`integer`, optional): Fetch and concatenate pages from page up to this page in one call (each page costs a credit). Example: 3.
- `num` (`integer`, optional): Results per page requested from eBay: 60, 120 or 240. One of: `60`, `120`, `240`.
- `page` (`integer`, optional): Page of results to fetch, starting at 1. Example: 2.
- `returns_accepted` (`boolean`, optional): Only items that accept returns.
- `sale_items` (`boolean`, optional): Only sale items.
- `search_term` (`string`, optional): Keywords to search for. Required unless url is given. Example: memory cards.
- `sort_by` (`string`, optional): 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_match`, `price_high_to_low`, `price_low_to_high`, `price_high_to_low_plus_postage`, `price_low_to_high_plus_postage`, `newly_listed`, `ending_soonest`.
- `url` (`string`, optional): 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.

Example input: `{}`

### `countdown_seller_feedback_get`

Get eBay Seller Feedback · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `customer_location` (`string`, optional): 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_zipcode` (`string`, optional): Zip or postal code to view eBay from; only some customer_location values support it. Example: 10001.
- `ebay_domain` (`string`, optional): eBay site to query, e.g. ebay.com, ebay.co.uk or ebay.de. One of: `ebay.com`, `ebay.co.uk`, `ebay.de`, `ebay.fr`, `ebay.it`, `ebay.es`, `ebay.ca`, `ebay.com.au`, `ebay.at`, `ebay.be`, `ebay.ch`, `ebay.ie`, `ebay.nl`, `ebay.pl`, `ebay.com.hk`, `ebay.com.my`, `ebay.com.sg`.
- `exclude_fields` (`string`, optional): Comma-separated JSON fields (dot notation) to remove from the response. Example: request_metadata.
- `include_fields` (`string`, optional): Comma-separated JSON fields (dot notation) to keep in the response, dropping everything else. Example: search_results,pagination.
- `max_page` (`integer`, optional): Fetch and concatenate pages from page up to this page in one call (each page costs a credit). Example: 3.
- `num` (`integer`, optional): Feedback per page: 25, 50, 100 or 200. One of: `25`, `50`, `100`, `200`.
- `page` (`integer`, optional): Page of results to fetch, starting at 1. Example: 2.
- `search_term` (`string`, optional): Only feedback containing this text; only with seller_feedback_type received_as_seller. Example: fast shipping.
- `seller_feedback_overall_rating` (`string`, optional): Only positive, neutral or negative feedback; needs a time period other than all and not left_for_others. One of: `positive`, `neutral`, `negative`.
- `seller_feedback_time_period` (`string`, optional): Period: all (default), one_month, six_months or twelve_months; only with received_as_buyer or received_as_seller. One of: `all`, `one_month`, `six_months`, `twelve_months`.
- `seller_feedback_type` (`string`, optional): Which feedback: all, received_as_buyer, received_as_seller or left_for_others. One of: `all`, `received_as_buyer`, `received_as_seller`, `left_for_others`.
- `seller_name` (`string`, optional): eBay seller user name; use with ebay_domain. Seller names come back from product and reviews results. Example: mobileking.
- `url` (`string`, optional): eBay seller feedback page URL, used when no seller_name is given.

Example input: `{}`

### `countdown_seller_profile_get`

Get eBay Seller Profile · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `customer_location` (`string`, optional): 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_zipcode` (`string`, optional): Zip or postal code to view eBay from; only some customer_location values support it. Example: 10001.
- `ebay_domain` (`string`, optional): eBay site to query, e.g. ebay.com, ebay.co.uk or ebay.de. One of: `ebay.com`, `ebay.co.uk`, `ebay.de`, `ebay.fr`, `ebay.it`, `ebay.es`, `ebay.ca`, `ebay.com.au`, `ebay.at`, `ebay.be`, `ebay.ch`, `ebay.ie`, `ebay.nl`, `ebay.pl`, `ebay.com.hk`, `ebay.com.my`, `ebay.com.sg`.
- `exclude_fields` (`string`, optional): Comma-separated JSON fields (dot notation) to remove from the response. Example: request_metadata.
- `include_fields` (`string`, optional): Comma-separated JSON fields (dot notation) to keep in the response, dropping everything else. Example: search_results,pagination.
- `is_store` (`boolean`, optional): true for an eBay storefront (uses the /str/ URL format instead of /usr/).
- `seller_name` (`string`, optional): eBay seller user name; use with ebay_domain. Seller names come back from product and reviews results. Example: mobileking.
- `url` (`string`, optional): eBay seller profile URL, used when no seller_name is given. Example: https://www.ebay.com/usr/mobileking.

Example input: `{}`

### `countdown_collection_delete`

Delete Collection · Destructive

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.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`string`, required): ID of the collection. Find it with countdown_collections_list. Example: 123456.

Example input: `{"collection_id":"<collection_id>"}`

### `countdown_collection_request_delete`

Delete Collection Request · Destructive

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.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`string`, required): ID of the collection. Find it with countdown_collections_list. Example: 123456.
- `request_id` (`string`, required): ID of the request to delete. Example: ABCDEFGHIJKLMNOP.

Example input: `{"collection_id":"<collection_id>","request_id":"<request_id>"}`

### `countdown_collection_requests_clear`

Clear Collection Requests · Destructive

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.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `collection_id` (`string`, required): ID of the collection. Find it with countdown_collections_list. Example: 123456.

Example input: `{"collection_id":"<collection_id>"}`

### `countdown_destination_delete`

Delete Destination · Destructive

Delete a Countdown API cloud storage destination. Collections stop uploading to it.
Returns request_info.success.
Use countdown_destinations_list to find the ID.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `destination_id` (`string`, required): ID of the destination. Example: ABCDEFG.

Example input: `{"destination_id":"<destination_id>"}`

## Related

Other Search connectors ([all 89](/agentkit/connectors/?category=search)):

- [Supadata](/agentkit/connectors/supadata/): Scalekit connector, API key, 21 tools
- [Exa](/agentkit/connectors/exa/): Scalekit connector, API key, 21 tools
- [Brave Search](/agentkit/connectors/brave/): Scalekit connector, API key, 18 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
