Countdown api | Composio Docs

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

API Key

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.

Select App

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

Configure Auth Config Settings

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

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

1 from composio import Composio
2 
3 # Replace these with your actual values
4 countdown_api_auth_config_id = "ac_YOUR_COUNTDOWN_API_CONFIG_ID" # Auth config ID created above
5 user_id = "0000-0000-0000"  # UUID from database/app
6 
7 composio = Composio()
8 
9 def 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 
27 connection_id = authenticate_toolkit(user_id, countdown_api_auth_config_id)
28 
29 # You can verify the connection using:
30 connected_account = composio.connected_accounts.get(connection_id)
31 print(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)

OpenAI (Python)

Anthropic (TypeScript)

Google (Python)

Vercel (TypeScript)

Python

1 from composio import Composio
2 from openai import OpenAI
3 import json
4 
5 openai = OpenAI()
6 composio = Composio()
7 
8 # User ID must be a valid UUID format
9 user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10 
11 tools = composio.tools.get(user_id=user_id, toolkits=["COUNTDOWN_API"])
12 
13 print("[!] Tools:")
14 print(json.dumps(tools))
15 
16 def invoke_llm(task = "What can you do?"):
17     completion = openai.chat.completions.create(
18         model="gpt-4o",
19         messages=[
20             {
21                 "role": "user",
22                 "content": task,  # Your task here!
23             },
24         ],
25         tools=tools,
26     )
27 
28     # Handle Result from tool call
29     result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30     print(f"[!] Completion: {completion}")
31     print(f"[!] Tool call result: {result}")
32 
33 invoke_llm()

Tool List

COUNTDOWN_API_CLEAR_ALL_REQUESTS

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

string

successful

booleanRequired

COUNTDOWN_API_COLLECTIONS_CREATE_COLLECTION

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

array

enabled

boolean

name

stringRequired

notification_as_csv

boolean

notification_as_json

boolean

notification_as_jsonlines

boolean

notification_csv_fields

string

notification_email

string

notification_webhook

string

priority

string

requests_type

string

schedule_days_of_month

array

schedule_days_of_week

array

schedule_hours

array

schedule_minutes

string

schedule_type

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

COUNTDOWN_API_COLLECTIONS_GET_COLLECTION

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

string

successful

booleanRequired

COUNTDOWN_API_COLLECTIONS_LIST_COLLECTIONS

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

string

created_before

string

destination_id

string

last_run_after

string

last_run_before

string

only_with_results

boolean

only_without_results

boolean

page

integerDefaults to 1

page_size

integerDefaults to 25

search_term

string

search_type

string

sort_by

stringDefaults to name

sort_direction

stringDefaults to ascending

status

stringDefaults to all

Action Response

data

objectRequired

error

string

successful

booleanRequired

COUNTDOWN_API_COLLECTIONS_START_COLLECTION

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

string

successful

booleanRequired

COUNTDOWN_API_COLLECTIONS_UPDATE_COLLECTION

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

array

enabled

boolean

name

stringRequired

notification_as_csv

boolean

notification_as_json

boolean

notification_as_jsonlines

boolean

notification_csv_fields

string

notification_email

string

notification_webhook

string

priority

string

requests_type

string

schedule_days_of_month

array

schedule_days_of_week

array

schedule_hours

array

schedule_minutes

string

schedule_type

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

COUNTDOWN_API_CORE_API_SEND_REQUEST

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

string

successful

booleanRequired

COUNTDOWN_API_CREATE_DESTINATION

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

string

azure_account_name

string

azure_container_name

string

azure_path_prefix

string

enabled

booleanRequired

gcs_access_key

string

gcs_bucket_name

string

gcs_path_prefix

string

gcs_secret_key

string

name

stringRequired

oss_access_key

string

oss_bucket_name

string

oss_path_prefix

string

oss_region_id

string

oss_secret_key

string

s3_access_key_id

string

s3_bucket_name

string

s3_endpoint

string

s3_path_prefix

string

s3_region

string

s3_secret_access_key

string

type

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

COUNTDOWN_API_DELETE_COLLECTION

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

string

successful

booleanRequired

COUNTDOWN_API_DELETE_DESTINATION

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

string

successful

booleanRequired

COUNTDOWN_API_DELETE_SINGLE_REQUEST

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

string

successful

booleanRequired

COUNTDOWN_API_DESTINATIONS_LIST_DESTINATIONS

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

integerDefaults to 1

search_term

string

sort_by

string

sort_direction

stringDefaults to ascending

Action Response

data

objectRequired

error

string

successful

booleanRequired

COUNTDOWN_API_GET_ACCOUNT

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

string

successful

booleanRequired

COUNTDOWN_API_REQUESTS_EXPORT_CSV

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

string

successful

booleanRequired

COUNTDOWN_API_REQUESTS_EXPORT_JSON

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

string

successful

booleanRequired

COUNTDOWN_API_REQUESTS_LIST_REQUESTS_PAGED

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

string

successful

booleanRequired

COUNTDOWN_API_REQUESTS_UPDATE_SINGLE_REQUEST

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

string

successful

booleanRequired

COUNTDOWN_API_RESULTS_GET_RESULT_SET

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

string

successful

booleanRequired

COUNTDOWN_API_RESULTS_LIST_RESULT_SETS

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

string

successful

booleanRequired

COUNTDOWN_API_RESULTS_RESEND_RESULT_SET_WEBHOOK

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

string

successful

booleanRequired

COUNTDOWN_API_STOP_ALL_COLLECTIONS

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

string

successful

booleanRequired

COUNTDOWN_API_STOP_COLLECTION

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

string

successful

booleanRequired

COUNTDOWN_API_UPDATE_DESTINATION

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

string

azure_account_name

string

azure_container_name

string

azure_path_prefix

string

destination_id

stringRequired

enabled

boolean

gcs_access_key

string

gcs_bucket_name

string

gcs_path_prefix

string

gcs_secret_key

string

name

string

oss_access_key

string

oss_bucket_name

string

oss_path_prefix

string

oss_region_id

string

oss_secret_key

string

s3_access_key_id

string

s3_bucket_name

string

s3_endpoint

string

s3_path_prefix

string

s3_region

string

s3_secret_access_key

string

type

string

Action Response

data

objectRequired

error

string

successful

booleanRequired