{
  "service": "countdown_api",
  "displayName": "Countdown API",
  "categories": [
    "Data",
    "Marketing"
  ],
  "authTypes": [
    "api_key"
  ],
  "auth": [
    {
      "type": "api_key",
      "label": "Countdown API Key",
      "placeholder": "COUNTDOWN_API_KEY",
      "description": "Countdown API key sent as the api key query parameter. Get one from the Countdown API sign-up page: https://app.countdownapi.com/signup"
    }
  ],
  "homepageUrl": "https://countdownapi.com/",
  "actions": [
    {
      "id": "countdown_api.autocomplete",
      "service": "countdown_api",
      "name": "autocomplete",
      "description": "Get eBay autocomplete suggestions for a search term through Countdown API.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "search_term": {
            "type": "string",
            "minLength": 1,
            "description": "The eBay search term to query."
          },
          "ebay_domain": {
            "type": "string",
            "minLength": 1,
            "description": "The eBay domain to query, such as ebay.com, ebay.co.uk, or ebay.de."
          }
        },
        "additionalProperties": false,
        "required": [
          "search_term",
          "ebay_domain"
        ],
        "description": "Countdown API autocomplete request."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The Countdown API response payload returned by the action."
          },
          "error": {
            "type": "string",
            "description": "Error if any occurred during the action execution."
          },
          "successful": {
            "type": "boolean",
            "description": "Whether the action execution was successful."
          }
        },
        "additionalProperties": false,
        "required": [
          "data",
          "successful"
        ],
        "description": "The Countdown API action result."
      }
    },
    {
      "id": "countdown_api.get_account",
      "service": "countdown_api",
      "name": "get_account",
      "description": "Retrieve Countdown API account usage, quota, and platform status details.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false,
        "description": "The input payload for retrieving Countdown API account details."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The Countdown API response payload returned by the action."
          },
          "error": {
            "type": "string",
            "description": "Error if any occurred during the action execution."
          },
          "successful": {
            "type": "boolean",
            "description": "Whether the action execution was successful."
          }
        },
        "additionalProperties": false,
        "required": [
          "data",
          "successful"
        ],
        "description": "The Countdown API action result."
      }
    },
    {
      "id": "countdown_api.get_product",
      "service": "countdown_api",
      "name": "get_product",
      "description": "Retrieve eBay product details by product ID through Countdown API.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "epid": {
            "type": "string",
            "minLength": 1,
            "description": "The eBay EPID product ID to retrieve."
          },
          "gtin": {
            "type": "string",
            "minLength": 1,
            "description": "The GTIN, ISBN, UPC, or EAN code to convert to an eBay EPID."
          },
          "ebay_url": {
            "type": "string",
            "description": "The eBay page URL to retrieve through Countdown API.",
            "format": "uri"
          },
          "ebay_domain": {
            "type": "string",
            "minLength": 1,
            "description": "The eBay domain to query, such as ebay.com, ebay.co.uk, or ebay.de."
          },
          "skip_gtin_cache": {
            "type": "boolean",
            "description": "Whether to force a fresh GTIN to EPID lookup."
          },
          "include_parts_compatibility": {
            "type": "boolean",
            "description": "Whether to include product parts compatibility details."
          },
          "customer_location": {
            "type": "string",
            "minLength": 1,
            "description": "The customer country location to use for eBay retrieval."
          },
          "customer_zipcode": {
            "type": "string",
            "minLength": 1,
            "description": "The customer ZIP or postal code to use for eBay retrieval."
          },
          "include_fields": {
            "type": "string",
            "minLength": 1,
            "description": "A comma-separated list of response field paths."
          },
          "exclude_fields": {
            "type": "string",
            "minLength": 1,
            "description": "A comma-separated list of response field paths."
          }
        },
        "additionalProperties": false,
        "description": "The input payload for retrieving an eBay product through Countdown API."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The Countdown API response payload returned by the action."
          },
          "error": {
            "type": "string",
            "description": "Error if any occurred during the action execution."
          },
          "successful": {
            "type": "boolean",
            "description": "Whether the action execution was successful."
          }
        },
        "additionalProperties": false,
        "required": [
          "data",
          "successful"
        ],
        "description": "The Countdown API action result."
      }
    },
    {
      "id": "countdown_api.search_products",
      "service": "countdown_api",
      "name": "search_products",
      "description": "Search eBay products through Countdown API with optional filters.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "search_term": {
            "type": "string",
            "minLength": 1,
            "description": "The eBay search term to query."
          },
          "ebay_url": {
            "type": "string",
            "description": "The eBay page URL to retrieve through Countdown API.",
            "format": "uri"
          },
          "ebay_domain": {
            "type": "string",
            "minLength": 1,
            "description": "The eBay domain to query, such as ebay.com, ebay.co.uk, or ebay.de."
          },
          "page": {
            "type": "integer",
            "minimum": 1,
            "description": "The result page number to request, starting at 1."
          },
          "max_page": {
            "type": "integer",
            "minimum": 1,
            "description": "The maximum result page number to retrieve when supported."
          },
          "category_id": {
            "type": "string",
            "minLength": 1,
            "description": "The eBay category ID used to narrow the search."
          },
          "listing_type": {
            "type": "string",
            "enum": [
              "all",
              "buy it now",
              "auction",
              "accepts offers"
            ],
            "description": "The eBay listing type filter to apply."
          },
          "condition": {
            "type": "string",
            "enum": [
              "all",
              "new",
              "used",
              "open box",
              "manufacturer refurbished",
              "seller refurbished",
              "parts or not working",
              "not specified"
            ],
            "description": "The eBay item condition filter to apply."
          },
          "sort_by": {
            "type": "string",
            "enum": [
              "best match",
              "price high to low",
              "price low to high",
              "price high to low plus postage",
              "price low to high plus postage",
              "newly listed",
              "ending soonest"
            ],
            "description": "The Countdown API sort option for product search results."
          },
          "num": {
            "type": "integer",
            "description": "The number of search results to request. Valid values are 60, 120, or 240."
          },
          "facets": {
            "type": "string",
            "minLength": 1,
            "description": "Comma-separated eBay search facets, such as brand=sandisk,format=microsd."
          },
          "sold_items": {
            "type": "boolean",
            "description": "Whether to filter search results to sold items."
          },
          "completed_items": {
            "type": "boolean",
            "description": "Whether to filter search results to completed items."
          },
          "authorized_sellers": {
            "type": "boolean",
            "description": "Whether to filter search results to authorized seller items."
          },
          "returns_accepted": {
            "type": "boolean",
            "description": "Whether to filter search results to returns accepted items."
          },
          "free_returns": {
            "type": "boolean",
            "description": "Whether to filter search results to free return items."
          },
          "authenticity_verified": {
            "type": "boolean",
            "description": "Whether to filter search results to authenticity verified items."
          },
          "deals_and_savings": {
            "type": "boolean",
            "description": "Whether to filter search results to deals and savings items."
          },
          "sale_items": {
            "type": "boolean",
            "description": "Whether to filter search results to sale items."
          },
          "allow_rewritten_results": {
            "type": "boolean",
            "description": "Whether to include rewritten eBay results."
          },
          "customer_location": {
            "type": "string",
            "minLength": 1,
            "description": "The customer country location to use for eBay retrieval."
          },
          "customer_zipcode": {
            "type": "string",
            "minLength": 1,
            "description": "The customer ZIP or postal code to use for eBay retrieval."
          },
          "include_fields": {
            "type": "string",
            "minLength": 1,
            "description": "A comma-separated list of response field paths."
          },
          "exclude_fields": {
            "type": "string",
            "minLength": 1,
            "description": "A comma-separated list of response field paths."
          }
        },
        "additionalProperties": false,
        "description": "The input payload for searching eBay products through Countdown API."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The Countdown API response payload returned by the action."
          },
          "error": {
            "type": "string",
            "description": "Error if any occurred during the action execution."
          },
          "successful": {
            "type": "boolean",
            "description": "Whether the action execution was successful."
          }
        },
        "additionalProperties": false,
        "required": [
          "data",
          "successful"
        ],
        "description": "The Countdown API action result."
      }
    }
  ]
}