Countdown API

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.

Ecommerce Developer Tools Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (23)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Clear Collection RequestsCOUNTDOWN_API_CLEAR_ALL_REQUESTSAcción

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

Parámetros de entrada

collection_idstringObligatorio
ID of the collection whose requests should be cleared

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create a new collectionCOUNTDOWN_API_COLLECTIONS_CREATE_COLLECTIONAcción

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

Parámetros de entrada

namestringObligatorio
Collection name
enabledboolean
Enable or disable scheduled runs
prioritystringenum
Collection priority
highesthighnormallowlowest
requests_typestringenum
Lock collection to a specific request type; cannot be changed after creation
mixedsearchproductreviewsseller profileseller feedbackautocompletedeals
schedule_typestringenum
Run schedule type
monthlyweeklydailyminutesmanual
schedule_hoursinteger[]
Hours (0-23) to run
destination_idsstring[]
Destination IDs to upload results to
schedule_minutesstringenum
Minute interval when schedule_type='minutes'
every minute51015202530hour
notification_emailstring
Email to send notifications to
notification_as_csvboolean
Output/upload results as CSV
notification_as_jsonboolean
Output/upload results as JSON
notification_webhookstringuri
Webhook URL to POST when results are available
schedule_days_of_weekinteger[]
Days of week (0=Sun ... 6=Sat) for weekly schedules
schedule_days_of_monthinteger[]
Days of month (1-31) for monthly schedules
notification_csv_fieldsstring
Comma-separated field list when CSV enabled
notification_as_jsonlinesboolean
Output/upload results as JSON Lines

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get CollectionCOUNTDOWN_API_COLLECTIONS_GET_COLLECTIONAcción

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

Parámetros de entrada

collection_idstringObligatorio
ID of the collection to retrieve

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List CollectionsCOUNTDOWN_API_COLLECTIONS_LIST_COLLECTIONSAcción

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

Parámetros de entrada

pageinteger
Page number to retrieve (default is 1).
statusstringenum
Filter by status. Default is 'all'.
allidlequeuedrunning
sort_bystringenum
Field to sort by (default 'name').
created_atlast_runnameprioritystatus
page_sizeinteger
Results per page (default 25, maximum 1000).
search_termstring
Limit results to collections whose name contains this term.
search_typestringenum
How to match the search_term. One of: contains, starts_with, ends_with, exact.
containsstarts_withends_withexact
created_afterstring
Only collections created after this ISO UTC timestamp (ISO 8601).
created_beforestring
Only collections created before this ISO UTC timestamp (ISO 8601).
destination_idstring
Only collections with the specified destination id.
last_run_afterstring
Only collections with last run after this ISO UTC timestamp (ISO 8601).
sort_directionstringenum
Sort direction (default 'ascending').
ascendingdescending
last_run_beforestring
Only collections with last run before this ISO UTC timestamp (ISO 8601).
only_with_resultsboolean
Only return collections that have result sets available.
only_without_resultsboolean
Only return collections with no result sets available.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Start CollectionCOUNTDOWN_API_COLLECTIONS_START_COLLECTIONAcción

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

Parámetros de entrada

collection_idstringObligatorio
ID of the collection to start processing

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update an existing collectionCOUNTDOWN_API_COLLECTIONS_UPDATE_COLLECTIONAcción

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

Parámetros de entrada

namestringObligatorio
Collection name
enabledboolean
Enable or disable scheduled runs
prioritystringenum
Collection priority
highesthighnormallowlowest
collection_idstringObligatorio
ID of the collection to update
requests_typestringenum
Lock collection to a specific request type; cannot be changed after creation
mixedsearchproductreviewsseller profileseller feedbackautocompletedeals
schedule_typestringenum
Run schedule type
monthlyweeklydailyminutesmanual
schedule_hoursinteger[]
Hours (0-23) to run
destination_idsstring[]
Destination IDs to upload results to
schedule_minutesstringenum
Minute interval when schedule_type='minutes'
every minuteevery 5 minutesevery 10 minutesevery 15 minutesevery 20 minutesevery 25 minutesevery 30 minutesevery hour
notification_emailstring
Email to send notifications to
notification_as_csvboolean
Output/upload results as CSV
notification_as_jsonboolean
Output/upload results as JSON
notification_webhookstringuri
Webhook URL to POST when results are available
schedule_days_of_weekinteger[]
Days of week (0=Sun...6=Sat) for weekly schedules
schedule_days_of_monthinteger[]
Days of month (1-31) for monthly schedules
notification_csv_fieldsstring
Comma-separated field list when CSV enabled
notification_as_jsonlinesboolean
Output/upload results as JSON Lines

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

eBay AutocompleteCOUNTDOWN_API_CORE_API_SEND_REQUESTAcción

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

Parámetros de entrada

typestringObligatorio
Must be "autocomplete" to retrieve autocomplete suggestions.
api_keystringObligatorio
Your Countdown API key.
ebay_domainstringObligatorio
eBay domain to retrieve autocomplete suggestions from, e.g., 'ebay.com'.
search_termstringObligatorio
The search term to get autocomplete suggestions for.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create DestinationCOUNTDOWN_API_CREATE_DESTINATIONAcción

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

Parámetros de entrada

namestringObligatorio
Destination name.
typestringObligatorioenum
Type of destination to create.
s3s3compatiblegcsazureoss
enabledbooleanObligatorio
Whether uploads are active for this destination.
s3_regionstring
S3 region (optional when type is s3compatible)
s3_endpointstring
S3 endpoint (required when type is s3compatible)
oss_region_idstring
OSS region ID (required when type is oss)
gcs_access_keystring
GCS access key (required when type is gcs)
gcs_secret_keystring
GCS secret key (required when type is gcs)
oss_access_keystring
OSS access key (required when type is oss)
oss_secret_keystring
OSS secret key (required when type is oss)
s3_bucket_namestring
S3 bucket name (required when type is s3 or s3compatible)
s3_path_prefixstring
S3 path prefix (optional)
gcs_bucket_namestring
GCS bucket name (required when type is gcs)
gcs_path_prefixstring
GCS path prefix (optional)
oss_bucket_namestring
OSS bucket name (required when type is oss)
oss_path_prefixstring
OSS path prefix (optional)
s3_access_key_idstring
S3 access key id (required when type is s3 or s3compatible)
azure_account_keystring
Azure account key (required when type is azure)
azure_path_prefixstring
Azure path prefix (optional)
azure_account_namestring
Azure account name (required when type is azure)
azure_container_namestring
Azure container name (required when type is azure)
s3_secret_access_keystring
S3 secret access key (required when type is s3 or s3compatible)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete CollectionCOUNTDOWN_API_DELETE_COLLECTIONAcción

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

Parámetros de entrada

collection_idstringObligatorio
ID of the collection to delete

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete DestinationCOUNTDOWN_API_DELETE_DESTINATIONAcción

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

Parámetros de entrada

destination_idstringObligatorio
ID of the destination to delete

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Single RequestCOUNTDOWN_API_DELETE_SINGLE_REQUESTAcción

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

Parámetros de entrada

request_idstringObligatorio
ID of the request to delete
collection_idstringObligatorio
ID of the collection the request belongs to

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List DestinationsCOUNTDOWN_API_DESTINATIONS_LIST_DESTINATIONSAcción

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

Parámetros de entrada

pageinteger
Page number to return; 10 destinations per page
sort_bystringenum
Sort field; valid values: 'type' or 'name'; use with sort_direction
typename
search_termstring
Filter results to destinations whose names contain this term
sort_directionstringenum
Sort direction; valid values: ascending or descending; use with sort_by
ascendingdescending

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Account InformationCOUNTDOWN_API_GET_ACCOUNTAcción

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

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Export Requests CSVCOUNTDOWN_API_REQUESTS_EXPORT_CSVAcción

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

Parámetros de entrada

collection_idstringObligatorio
The ID of the collection whose requests you want to export as CSV.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Export Requests as JSONCOUNTDOWN_API_REQUESTS_EXPORT_JSONAcción

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

Parámetros de entrada

collection_idstringObligatorio
ID of the collection to export requests from

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Requests PagedCOUNTDOWN_API_REQUESTS_LIST_REQUESTS_PAGEDAcción

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.

Parámetros de entrada

pageintegerObligatorio
1-indexed page number; each page returns up to 1000 requests
collection_idstringObligatorio
ID of the collection to list requests from

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update Single RequestCOUNTDOWN_API_REQUESTS_UPDATE_SINGLE_REQUESTAcción

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.

Parámetros de entrada

bodyobjectObligatorio
Fields to update on the request; must conform to the eBay Product Data API common request parameters schema. Only include fields being updated.
request_idstringObligatorio
ID of the specific request to update within the collection.
collection_idstringObligatorio
ID of the collection containing the request to update.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Result SetCOUNTDOWN_API_RESULTS_GET_RESULT_SETAcción

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

Parámetros de entrada

collection_idstringObligatorio
ID of the collection containing the result set
result_set_idintegerObligatorio
Numeric ID of the result set within the collection

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Result SetsCOUNTDOWN_API_RESULTS_LIST_RESULT_SETSAcción

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.

Parámetros de entrada

collection_idstringObligatorio
ID of the collection to list result sets for

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Resend Result Set WebhookCOUNTDOWN_API_RESULTS_RESEND_RESULT_SET_WEBHOOKAcción

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

Parámetros de entrada

collection_idstringObligatorio
ID of the collection containing the result set
result_set_idintegerObligatorio
Numeric ID of the result set within the collection

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Stop All CollectionsCOUNTDOWN_API_STOP_ALL_COLLECTIONSAcción

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

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Stop CollectionCOUNTDOWN_API_STOP_COLLECTIONAcción

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.

Parámetros de entrada

collection_idstringObligatorio
ID of the collection to stop

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update DestinationCOUNTDOWN_API_UPDATE_DESTINATIONAcción

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

Parámetros de entrada

namestring
Destination name
typestringenum
Destination type
s3s3compatiblegcsazureoss
enabledboolean
Whether uploads are active for this destination
s3_regionstring
S3 region (optional when type is s3compatible)
s3_endpointstring
S3 endpoint URL (required when type is s3compatible)
oss_region_idstring
OSS region ID (required when type is oss)
destination_idstringObligatorio
ID of the destination to update
gcs_access_keystring
GCS access key (required when type is gcs)
gcs_secret_keystring
GCS secret key (required when type is gcs)
oss_access_keystring
OSS access key (required when type is oss)
oss_secret_keystring
OSS secret key (required when type is oss)
s3_bucket_namestring
S3 bucket name (required when type is s3 or s3compatible)
s3_path_prefixstring
S3 path prefix (optional); supports tokens %collection_id%, %collection_name%, %result_set_id%, %date%
gcs_bucket_namestring
GCS bucket name (required when type is gcs)
gcs_path_prefixstring
GCS path prefix (optional); supports tokens %collection_id%, %collection_name%, %result_set_id%, %date%
oss_bucket_namestring
OSS bucket name (required when type is oss)
oss_path_prefixstring
OSS path prefix (optional); supports tokens %collection_id%, %collection_name%, %result_set_id%, %date%
s3_access_key_idstring
S3 access key id (required when type is s3 or s3compatible)
azure_account_keystring
Azure account key (required when type is azure)
azure_path_prefixstring
Azure path prefix (optional); supports tokens %collection_id%, %collection_name%, %result_set_id%, %date%
azure_account_namestring
Azure account name (required when type is azure)
azure_container_namestring
Azure container name (required when type is azure)
s3_secret_access_keystring
S3 secret access key (required when type is s3 or s3compatible)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not