E Commerce

Countdown API

Learn how to use Countdown API with Composio

Overview

SLUG: COUNTDOWN_API

Description

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.

Authentication Details

generic_api_key
stringRequired

Connecting to Countdown API

Create an auth config

Use the dashboard to create an auth config for the Countdown API toolkit. This allows you to connect multiple Countdown API accounts to Composio for agents to use.

1

Select App

Navigate to [Countdown API](https://platform.composio.dev?next_page=/marketplace/Countdown API).

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Countdown API Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4countdown_api_auth_config_id = "ac_YOUR_COUNTDOWN_API_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000"  # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10    # Replace this with a method to retrieve an API key from the user.
11    # Or supply your own.
12    user_api_key = input("[!] Enter API key")
13
14    connection_request = composio.connected_accounts.initiate(
15        user_id=user_id,
16        auth_config_id=auth_config_id,
17        config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18    )
19
20    # API Key authentication is immediate - no redirect needed
21    print(f"Successfully connected Countdown API for user {user_id}")
22    print(f"Connection status: {connection_request.status}")
23    
24    return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, countdown_api_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the [Countdown API toolkit’s playground](https://app.composio.dev/app/Countdown API)

For code examples, see the Tool calling guide and Provider examples.

Tool List

Tool Name: Clear Collection Requests

Description

Tool to clear all requests from a specified collection. Use when you need to remove all queued requests for an idle collection.

Action Parameters

collection_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create a new collection

Description

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

Action Parameters

destination_ids
enabled
name
stringRequired
notification_as_csv
notification_as_json
notification_as_jsonlines
notification_csv_fields
notification_email
notification_webhook
priority
requests_type
schedule_days_of_month
schedule_days_of_week
schedule_hours
schedule_minutes
schedule_type

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Collection

Description

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

Action Parameters

collection_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Collections

Description

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

Action Parameters

created_after
created_before
destination_id
last_run_after
last_run_before
only_with_results
only_without_results
page
Defaults to 1
page_size
Defaults to 25
search_term
search_type
sort_by
Defaults to name
sort_direction
Defaults to ascending
status
Defaults to all

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Start Collection

Description

Tool to start processing a collection's queued requests. Use after creating or pausing a collection to initiate its queued requests.

Action Parameters

collection_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update an existing collection

Description

Tool to update an existing collection. Use when you need to modify collection settings before scheduling runs.

Action Parameters

collection_id
stringRequired
destination_ids
enabled
name
stringRequired
notification_as_csv
notification_as_json
notification_as_jsonlines
notification_csv_fields
notification_email
notification_webhook
priority
requests_type
schedule_days_of_month
schedule_days_of_week
schedule_hours
schedule_minutes
schedule_type

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: eBay Autocomplete

Description

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

Action Parameters

api_key
stringRequired
ebay_domain
stringRequired
search_term
stringRequired
type
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Destination

Description

Tool to create a destination. Use when you need to set up a new destination for results or notifications.

Action Parameters

azure_account_key
azure_account_name
azure_container_name
azure_path_prefix
enabled
booleanRequired
gcs_access_key
gcs_bucket_name
gcs_path_prefix
gcs_secret_key
name
stringRequired
oss_access_key
oss_bucket_name
oss_path_prefix
oss_region_id
oss_secret_key
s3_access_key_id
s3_bucket_name
s3_endpoint
s3_path_prefix
s3_region
s3_secret_access_key
type
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Collection

Description

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

Action Parameters

collection_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Destination

Description

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

Action Parameters

destination_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Single Request

Description

Tool to remove a specific request from a collection. Use when you need to delete one request by ID.

Action Parameters

collection_id
stringRequired
request_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Destinations

Description

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

Action Parameters

page
Defaults to 1
search_term
sort_by
sort_direction
Defaults to ascending

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Account Information

Description

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

Action Parameters

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Export Requests CSV

Description

Tool to export all requests in a collection as CSV download links. Use when you need per-page CSV URLs for a given collection.

Action Parameters

collection_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Export Requests as JSON

Description

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

Action Parameters

collection_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Requests Paged

Description

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.

Action Parameters

collection_id
stringRequired
page
integerRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Single Request

Description

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.

Action Parameters

body
objectRequired
collection_id
stringRequired
request_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Result Set

Description

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

Action Parameters

collection_id
stringRequired
result_set_id
integerRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Result Sets

Description

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.

Action Parameters

collection_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Resend Result Set Webhook

Description

Tool to resend the webhook for a previously generated result set. Use when a result set's webhook delivery needs a retry.

Action Parameters

collection_id
stringRequired
result_set_id
integerRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Stop All Collections

Description

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

Action Parameters

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Stop Collection

Description

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.

Action Parameters

collection_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Destination

Description

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

Action Parameters

azure_account_key
azure_account_name
azure_container_name
azure_path_prefix
destination_id
stringRequired
enabled
gcs_access_key
gcs_bucket_name
gcs_path_prefix
gcs_secret_key
name
oss_access_key
oss_bucket_name
oss_path_prefix
oss_region_id
oss_secret_key
s3_access_key_id
s3_bucket_name
s3_endpoint
s3_path_prefix
s3_region
s3_secret_access_key
type

Action Response

data
objectRequired
error
successful
booleanRequired