# Countdown API

Countdown API provides real-time eBay product data, including product details, customer reviews, seller feedback, and search results, enabling businesses and developers to access comprehensive eBay marketplace information.

- **Category:** ecommerce
- **Auth:** API_KEY
- **Tools:** 23
- **Triggers:** 0
- **Slug:** `COUNTDOWN_API`
- **Version:** 20260211_00

## Tools

### Clear Collection Requests

**Slug:** `COUNTDOWN_API_CLEAR_ALL_REQUESTS`

Clears (removes) all pending requests from a collection. Use this to reset a collection before adding new requests, or to cancel all queued requests. The collection must be in 'idle' status. Returns the updated collection details after clearing.

### Create a new collection

**Slug:** `COUNTDOWN_API_COLLECTIONS_CREATE_COLLECTION`

Tool to create a new collection. Use when you need to batch and orchestrate multiple requests on a schedule.

### Get Collection

**Slug:** `COUNTDOWN_API_COLLECTIONS_GET_COLLECTION`

Tool to retrieve details for a single collection by ID. Use when you need collection metadata and counts for a given collection ID.

### List Collections

**Slug:** `COUNTDOWN_API_COLLECTIONS_LIST_COLLECTIONS`

Tool to list all collections for the authenticated account. Use when you need to retrieve paginated collections with filtering, sorting, and timing constraints.

### Start Collection

**Slug:** `COUNTDOWN_API_COLLECTIONS_START_COLLECTION`

Start processing a collection's queued requests on the Countdown API. Use this tool to manually trigger a collection to begin executing its requests. The collection must have at least one request added to it before it can be started. You need sufficient API credits to run all requests in the collection. Prerequisites: - Collection must exist (use List Collections or Create Collection first) - Collection must have at least one request added - Sufficient API credits available for the number of requests - Collection must not already be running

### Update an existing collection

**Slug:** `COUNTDOWN_API_COLLECTIONS_UPDATE_COLLECTION`

Update an existing collection's settings. Use this to modify collection properties like name, schedule, priority, notification settings, or enabled status. The collection_id must be obtained from list_collections or create_collection. Only specified fields are updated; omitted fields retain their current values.

### eBay Autocomplete

**Slug:** `COUNTDOWN_API_CORE_API_SEND_REQUEST`

Tool to fetch eBay autocomplete suggestions. Use when needing search-term-based suggestions from Countdown API.

### Create Destination

**Slug:** `COUNTDOWN_API_CREATE_DESTINATION`

Creates a cloud storage destination where batch result sets will be automatically uploaded. Supports Amazon S3, S3-compatible services (MinIO, DigitalOcean Spaces), Google Cloud Storage, Microsoft Azure Blob Storage, and Alibaba Cloud OSS. When enabled=true, the API validates credentials by uploading and deleting a test file. Set enabled=false to create the destination without credential validation.

### Delete Collection

**Slug:** `COUNTDOWN_API_DELETE_COLLECTION`

Tool to delete a collection and its configuration by ID. Use when you need to remove an existing, non-running collection.

### Delete Destination

**Slug:** `COUNTDOWN_API_DELETE_DESTINATION`

Tool to delete a destination by ID. Use when you need to remove an existing destination.

### Delete Single Request

**Slug:** `COUNTDOWN_API_DELETE_SINGLE_REQUEST`

Delete a specific request from a Countdown API collection by its ID. Use this to remove individual requests that are no longer needed. The collection must not be running when deleting requests.

### List Destinations

**Slug:** `COUNTDOWN_API_DESTINATIONS_LIST_DESTINATIONS`

Tool to list all destinations configured for the account. Use when you need to inspect or paginate through configured destinations.

### Get Account Information

**Slug:** `COUNTDOWN_API_GET_ACCOUNT`

Tool to retrieve account usage and current platform status. Use when needing to check plan, usage, and quota details for the authenticated user.

### Export Requests CSV

**Slug:** `COUNTDOWN_API_REQUESTS_EXPORT_CSV`

Export all requests from a collection as downloadable CSV files. Returns URLs to CSV files containing the request data. Use this tool when you need to bulk export or download collection request data in CSV format. The response includes paginated download links if the collection has many requests. Collections with no requests will return an empty pages array.

### Export Requests as JSON

**Slug:** `COUNTDOWN_API_REQUESTS_EXPORT_JSON`

Tool to download all requests in a collection as JSON. Use when you need to export the entire request history for a collection.

### List Requests Paged

**Slug:** `COUNTDOWN_API_REQUESTS_LIST_REQUESTS_PAGED`

Tool to list requests for a collection by page. Use when you need to fetch a specific batch of up to 1000 requests for a given collection.

### Update Single Request

**Slug:** `COUNTDOWN_API_REQUESTS_UPDATE_SINGLE_REQUEST`

Tool to modify parameters of an existing request in a collection. Use when the collection is not running and you need to update eBay Product Data API parameters.

### Get Result Set

**Slug:** `COUNTDOWN_API_RESULTS_GET_RESULT_SET`

Tool to retrieve a collection run's result set payload. Use after a collection run completes to fetch metadata and download links.

### List Result Sets

**Slug:** `COUNTDOWN_API_RESULTS_LIST_RESULT_SETS`

Tool to list result sets produced by a collection. Use when you need to retrieve all summary status of result sets generated by a collection within the 14-day retention window.

### Resend Result Set Webhook

**Slug:** `COUNTDOWN_API_RESULTS_RESEND_RESULT_SET_WEBHOOK`

Resend the webhook notification for a collection's result set. Use this tool to retry webhook delivery when the original webhook POST failed or timed out. The collection must have a notification_webhook URL configured (either on the collection itself or on the account profile). Result sets are only available for 14 days after creation. Prerequisites: - Collection must exist with a valid notification_webhook URL configured - Result set must exist and not be expired (14-day retention) - Use List Result Sets to find valid result_set_id values

### Stop All Collections

**Slug:** `COUNTDOWN_API_STOP_ALL_COLLECTIONS`

Tool to stop all collections. Use when you need to halt any running or queued collections after reviewing operations.

### Stop Collection

**Slug:** `COUNTDOWN_API_STOP_COLLECTION`

Tool to stop (pause) a single collection’s processing by ID. Use when you need to halt a running or queued collection after confirming the target collection ID.

### Update Destination

**Slug:** `COUNTDOWN_API_UPDATE_DESTINATION`

Tool to update a destination's configuration by ID. Use after creating or retrieving a destination to modify its settings.
