Volver al catálogo

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.

Acciones
23
Triggers
0
Autenticación
—
OAuth gestionado
No
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