{
  "url": "https://telipot.com/catalog/capabilities/company.search",
  "id": "company.search",
  "description": "Companies that match industry, size and location filters",
  "platform": "company",
  "providers": [
    {
      "slug": "hunter",
      "name": "Hunter"
    },
    {
      "slug": "apollo",
      "name": "Apollo"
    }
  ],
  "tasks": 2,
  "taskPages": [
    {
      "id": "hunter.company.search",
      "name": "Companies by industry, headcount, location and keywords",
      "provider": {
        "slug": "hunter",
        "name": "Hunter"
      },
      "capability": "company.search",
      "platform": "company",
      "kind": "data",
      "tier": "core",
      "identity": "key",
      "identityLabel": "Your plan",
      "price": {
        "amount": "Free",
        "state": "free",
        "label": "Free",
        "detail": "Free from the tool",
        "type": "free"
      },
      "providers": 2,
      "retention": "standard",
      "runsOn": "free",
      "live": true,
      "summary": "Returns companies matching a set of criteria.",
      "method": "POST",
      "path": "/discover",
      "host": "https://api.hunter.io/v2",
      "docsUrl": "https://hunter.io/api-documentation/v2#discover",
      "auth": {
        "scheme": "api_key",
        "label": "api_key · in header as X-API-KEY",
        "short": "api_key · x-api-key"
      },
      "scope": "any_account",
      "principal": "organization",
      "requiredScopes": [],
      "verification": {
        "state": "none",
        "label": "Not verified yet",
        "detail": "Not checked yet. We test with a real request before we mark it."
      },
      "input": [
        {
          "name": "query",
          "location": "body",
          "type": "string",
          "required": false,
          "constraints": [
            "at most 2000"
          ],
          "note": "Plain-language description; Hunter's AI assistant picks the filters and returns them in meta.filters, which are better to reuse than the sentence when paging. Required unless a filter is given."
        },
        {
          "name": "organization",
          "location": "body",
          "type": "object",
          "required": false,
          "constraints": [],
          "note": "{ domain: [..], name: [..] }. Lists of domains and company names to select; when both are given the results combine into one set of domains."
        },
        {
          "name": "headquarters_location",
          "location": "body",
          "type": "object",
          "required": false,
          "constraints": [],
          "note": "{ include: [..], exclude: [..] }, each location one of continent (Europe, Asia, North America, Africa, Antarctica, South America, Oceania), business_region (AMER, EMEA, APAC, LATAM), or country (ISO 3166-1 alpha-2) with optional state and city. A city needs a country; a US city needs a state."
        },
        {
          "name": "industry",
          "location": "body",
          "type": "object",
          "required": false,
          "constraints": [],
          "note": "{ include: [..], exclude: [..] } of names from https://hunter.io/files/industries.json."
        },
        {
          "name": "headcount",
          "location": "body",
          "type": "array",
          "required": false,
          "constraints": [],
          "note": "Company size ranges to keep. One or more of 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+."
        },
        {
          "name": "company_type",
          "location": "body",
          "type": "object",
          "required": false,
          "constraints": [],
          "note": "{ include: [..], exclude: [..] } of educational, educational institution, government agency, non profit, partnership, privately held, public company, self employed, self owned, sole proprietorship."
        },
        {
          "name": "keywords",
          "location": "body",
          "type": "object",
          "required": false,
          "constraints": [],
          "note": "{ include: [..], exclude: [..], match: any|all }, at most 100 keywords per list; match defaults to all."
        },
        {
          "name": "job_openings",
          "location": "body",
          "type": "object",
          "required": false,
          "constraints": [],
          "note": "{ hiring, department: [..], job_title: { include, exclude }, posted_date: last7d|last30d|last90d, open_roles: { from, to }, include_closed_roles }. Department values are case-sensitive; any field selects companies that are hiring."
        },
        {
          "name": "year_founded",
          "location": "body",
          "type": "object",
          "required": false,
          "constraints": [],
          "note": "{ include: [..], exclude: [..] } or { from, to }, four-digit years. Premium plan only."
        },
        {
          "name": "technology",
          "location": "body",
          "type": "object",
          "required": false,
          "constraints": [],
          "note": "{ include: [..], exclude: [..], match: any|all } of slugs from https://hunter.io/files/technologies.json. Premium plan only."
        },
        {
          "name": "funding",
          "location": "body",
          "type": "object",
          "required": false,
          "constraints": [],
          "note": "{ series: [..], amount: { from, to }, date: { from, to } }; series is one or more of pre_seed, seed, pre_series_a, series_a, pre_series_b, series_b, pre_series_c, series_c+, other. Premium plan only."
        },
        {
          "name": "limit",
          "location": "body",
          "type": "integer",
          "required": false,
          "constraints": [
            "1 to 100",
            "default 100"
          ],
          "note": "Companies per page. Premium plan only; changing it on a Free plan returns 400 pagination_error."
        },
        {
          "name": "offset",
          "location": "body",
          "type": "integer",
          "required": false,
          "constraints": [
            "0 to 10000",
            "default 0"
          ],
          "note": "Companies to skip. Premium plan only; changing it on a Free plan returns 400 pagination_error."
        }
      ],
      "sampleInput": {
        "organization": {
          "domain": [
            "stripe.com"
          ]
        }
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Plain-language description; Hunter's AI assistant picks the filters and returns them in meta.filters, which are better to reuse than the sentence when paging. Required unless a filter is given.",
            "examples": [
              "Companies in Europe that specialize in software development"
            ],
            "maxLength": 2000
          },
          "organization": {
            "type": "object",
            "description": "{ domain: [..], name: [..] }. Lists of domains and company names to select; when both are given the results combine into one set of domains.",
            "examples": [
              {
                "domain": [
                  "stripe.com"
                ]
              }
            ]
          },
          "headquarters_location": {
            "type": "object",
            "description": "{ include: [..], exclude: [..] }, each location one of continent (Europe, Asia, North America, Africa, Antarctica, South America, Oceania), business_region (AMER, EMEA, APAC, LATAM), or country (ISO 3166-1 alpha-2) with optional state and city. A city needs a country; a US city needs a state.",
            "examples": [
              {
                "include": [
                  {
                    "country": "FR",
                    "city": "Paris"
                  }
                ]
              }
            ]
          },
          "industry": {
            "type": "object",
            "description": "{ include: [..], exclude: [..] } of names from https://hunter.io/files/industries.json.",
            "examples": [
              {
                "include": [
                  "Financial Services"
                ]
              }
            ]
          },
          "headcount": {
            "type": "array",
            "description": "Company size ranges to keep. One or more of 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+.",
            "examples": [
              [
                "51-200",
                "201-500"
              ]
            ]
          },
          "company_type": {
            "type": "object",
            "description": "{ include: [..], exclude: [..] } of educational, educational institution, government agency, non profit, partnership, privately held, public company, self employed, self owned, sole proprietorship.",
            "examples": [
              {
                "include": [
                  "privately held"
                ]
              }
            ]
          },
          "keywords": {
            "type": "object",
            "description": "{ include: [..], exclude: [..], match: any|all }, at most 100 keywords per list; match defaults to all.",
            "examples": [
              {
                "include": [
                  "payments"
                ],
                "match": "any"
              }
            ]
          },
          "job_openings": {
            "type": "object",
            "description": "{ hiring, department: [..], job_title: { include, exclude }, posted_date: last7d|last30d|last90d, open_roles: { from, to }, include_closed_roles }. Department values are case-sensitive; any field selects companies that are hiring.",
            "examples": [
              {
                "hiring": true,
                "department": [
                  "engineering"
                ]
              }
            ]
          },
          "year_founded": {
            "type": "object",
            "description": "{ include: [..], exclude: [..] } or { from, to }, four-digit years. Premium plan only.",
            "examples": [
              {
                "from": 2015,
                "to": 2020
              }
            ]
          },
          "technology": {
            "type": "object",
            "description": "{ include: [..], exclude: [..], match: any|all } of slugs from https://hunter.io/files/technologies.json. Premium plan only.",
            "examples": [
              {
                "include": [
                  "stripe"
                ],
                "match": "any"
              }
            ]
          },
          "funding": {
            "type": "object",
            "description": "{ series: [..], amount: { from, to }, date: { from, to } }; series is one or more of pre_seed, seed, pre_series_a, series_a, pre_series_b, series_b, pre_series_c, series_c+, other. Premium plan only.",
            "examples": [
              {
                "series": [
                  "seed",
                  "series_a"
                ]
              }
            ]
          },
          "limit": {
            "type": "integer",
            "description": "Companies per page. Premium plan only; changing it on a Free plan returns 400 pagination_error.",
            "default": 100,
            "minimum": 1,
            "maximum": 100
          },
          "offset": {
            "type": "integer",
            "description": "Companies to skip. Premium plan only; changing it on a Free plan returns 400 pagination_error.",
            "default": 0,
            "minimum": 0,
            "maximum": 10000
          }
        },
        "additionalProperties": false
      },
      "output": [
        {
          "name": "data",
          "type": "object[]"
        },
        {
          "name": "meta",
          "type": "object"
        }
      ],
      "outputSchema": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "domain",
                "organization",
                "emails_count"
              ],
              "properties": {
                "domain": {
                  "type": "string"
                },
                "organization": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "emails_count": {
                  "type": "object",
                  "properties": {
                    "personal": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "generic": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "total": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    }
                  }
                },
                "description": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "industry": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "technologies": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "country": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "state": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "city": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "headcount": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "company_type": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "year_founded": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "keywords": {
                  "type": [
                    "array",
                    "null"
                  ],
                  "items": {
                    "type": "string"
                  }
                },
                "already_saved": {
                  "type": "boolean"
                }
              }
            }
          },
          "meta": {
            "type": "object",
            "required": [
              "results",
              "limit",
              "offset"
            ],
            "properties": {
              "results": {
                "type": "integer"
              },
              "limit": {
                "type": "integer"
              },
              "offset": {
                "type": "integer"
              },
              "params": {
                "type": "object"
              },
              "filters": {
                "type": "object"
              },
              "permalink": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        }
      },
      "commands": {
        "mode": "run",
        "cli": "telipot run hunter.company.search \\\n  --input-json '{\"organization\":{\"domain\":[\"stripe.com\"]}}'",
        "http": "curl https://api.telipot.com/v1/tasks/hunter.company.search/run \\\n  -H \"Authorization: Bearer $TELIPOT_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"organization\":{\"domain\":[\"stripe.com\"]}}'",
        "quote": "telipot run hunter.company.search \\\n  --input-json '{\"organization\":{\"domain\":[\"stripe.com\"]}}' \\\n  --quote"
      },
      "siblings": [
        {
          "id": "apollo.company.search",
          "name": "Companies by domain, size, location, funding, tech filters",
          "provider": {
            "slug": "apollo",
            "name": "Apollo"
          },
          "capability": "company.search",
          "platform": "company",
          "kind": "data",
          "tier": "core",
          "identity": "key",
          "identityLabel": "Your plan",
          "price": {
            "type": "per_call",
            "confidence": "documented",
            "source": "docs",
            "sourceUrl": "https://docs.apollo.io/docs/api-pricing",
            "checked": "2026-10-05",
            "note": "1 credit per page, up to 100 results per page; per_page does not change the charge.",
            "state": "paid",
            "label": "$0.0196 / call",
            "amount": "$0.0196",
            "unit": "call",
            "usdPerUnit": {
              "floor": 0.0196,
              "ceiling": 0.0196
            },
            "native": {
              "text": "1 credit per call",
              "figure": "1 credit",
              "per": "call",
              "currency": "credits"
            },
            "detail": "1 credit · docs"
          },
          "providers": 2,
          "retention": "standard",
          "runsOn": "byoc",
          "live": true
        }
      ]
    },
    {
      "id": "apollo.company.search",
      "name": "Companies by domain, size, location, funding, tech filters",
      "provider": {
        "slug": "apollo",
        "name": "Apollo"
      },
      "capability": "company.search",
      "platform": "company",
      "kind": "data",
      "tier": "core",
      "identity": "key",
      "identityLabel": "Your plan",
      "price": {
        "type": "per_call",
        "confidence": "documented",
        "source": "docs",
        "sourceUrl": "https://docs.apollo.io/docs/api-pricing",
        "checked": "2026-10-05",
        "note": "1 credit per page, up to 100 results per page; per_page does not change the charge.",
        "state": "paid",
        "label": "$0.0196 / call",
        "amount": "$0.0196",
        "unit": "call",
        "usdPerUnit": {
          "floor": 0.0196,
          "ceiling": 0.0196
        },
        "native": {
          "text": "1 credit per call",
          "figure": "1 credit",
          "per": "call",
          "currency": "credits"
        },
        "detail": "1 credit · docs"
      },
      "providers": 2,
      "retention": "standard",
      "runsOn": "byoc",
      "live": true,
      "summary": "Use the organization search endpoint to find companies in the Apollo database.",
      "method": "POST",
      "path": "/mixed_companies/search",
      "host": "https://api.apollo.io/api/v1",
      "docsUrl": "https://docs.apollo.io/reference/organization-search",
      "auth": {
        "scheme": "api_key",
        "label": "api_key · in header as x-api-key",
        "short": "api_key · x-api-key"
      },
      "scope": "any_account",
      "principal": "organization",
      "requiredScopes": [],
      "verification": {
        "state": "none",
        "label": "Not verified yet",
        "detail": "Not checked yet. We test with a real request before we mark it."
      },
      "input": [
        {
          "name": "q_organization_domains_list[]",
          "location": "queryParams",
          "type": "array",
          "required": false,
          "constraints": [
            "at most 1000"
          ],
          "note": "Company domains, without www. or @; up to 1,000. Examples: apollo.io; microsoft.com."
        },
        {
          "name": "organization_num_employees_ranges[]",
          "location": "queryParams",
          "type": "array",
          "required": false,
          "constraints": [],
          "note": "Headcount ranges as lower,upper strings. Examples: 1,10; 250,500; 10000,20000."
        },
        {
          "name": "organization_locations[]",
          "location": "queryParams",
          "type": "array",
          "required": false,
          "constraints": [],
          "note": "Headquarters location: cities, US states or countries. Examples: texas; tokyo; spain."
        },
        {
          "name": "organization_not_locations[]",
          "location": "queryParams",
          "type": "array",
          "required": false,
          "constraints": [],
          "note": "Exclude companies by headquarters location: cities, US states or countries. Examples: minnesota; ireland."
        },
        {
          "name": "revenue_range[min]",
          "location": "queryParams",
          "type": "integer",
          "required": false,
          "constraints": [],
          "note": "Minimum revenue, digits only (no currency symbol, comma or decimal point). Pair with revenue_range[max]."
        },
        {
          "name": "revenue_range[max]",
          "location": "queryParams",
          "type": "integer",
          "required": false,
          "constraints": [],
          "note": "Maximum revenue, digits only. Pair with revenue_range[min]."
        },
        {
          "name": "currently_using_any_of_technology_uids[]",
          "location": "queryParams",
          "type": "array",
          "required": false,
          "constraints": [],
          "note": "Company must use any of these. Technology uids; replace spaces and periods with underscores. Apollo filters on 1,500+ technologies. Examples: salesforce; google_analytics; wordpress_org."
        },
        {
          "name": "q_organization_keyword_tags[]",
          "location": "queryParams",
          "type": "array",
          "required": false,
          "constraints": [],
          "note": "Keywords associated with companies. Examples: mining; sales strategy; consulting."
        },
        {
          "name": "q_organization_name",
          "location": "queryParams",
          "type": "string",
          "required": false,
          "constraints": [],
          "note": "Company name; partial matches are accepted, so marketing matches NY Marketing Unlimited."
        },
        {
          "name": "organization_ids[]",
          "location": "queryParams",
          "type": "array",
          "required": false,
          "constraints": [],
          "note": "Apollo IDs of companies to include; this route returns them as id."
        },
        {
          "name": "latest_funding_amount_range[min]",
          "location": "queryParams",
          "type": "integer",
          "required": false,
          "constraints": [],
          "note": "Minimum amount of the most recent funding round, digits only. Pair with latest_funding_amount_range[max]."
        },
        {
          "name": "latest_funding_amount_range[max]",
          "location": "queryParams",
          "type": "integer",
          "required": false,
          "constraints": [],
          "note": "Maximum amount of the most recent funding round, digits only."
        },
        {
          "name": "total_funding_range[min]",
          "location": "queryParams",
          "type": "integer",
          "required": false,
          "constraints": [],
          "note": "Minimum total funding across all rounds, digits only. Pair with total_funding_range[max]."
        },
        {
          "name": "total_funding_range[max]",
          "location": "queryParams",
          "type": "integer",
          "required": false,
          "constraints": [],
          "note": "Maximum total funding across all rounds, digits only."
        },
        {
          "name": "latest_funding_date_range[min]",
          "location": "queryParams",
          "type": "string",
          "required": false,
          "constraints": [],
          "note": "Earliest date of the most recent funding round, YYYY-MM-DD. Pair with latest_funding_date_range[max]."
        },
        {
          "name": "latest_funding_date_range[max]",
          "location": "queryParams",
          "type": "string",
          "required": false,
          "constraints": [],
          "note": "Latest date of the most recent funding round, YYYY-MM-DD."
        },
        {
          "name": "q_organization_job_titles[]",
          "location": "queryParams",
          "type": "array",
          "required": false,
          "constraints": [],
          "note": "Job titles in the company's active job postings. Examples: sales manager; research analyst."
        },
        {
          "name": "organization_job_locations[]",
          "location": "queryParams",
          "type": "array",
          "required": false,
          "constraints": [],
          "note": "Locations of the jobs the company is recruiting for. Examples: atlanta; japan."
        },
        {
          "name": "organization_num_jobs_range[min]",
          "location": "queryParams",
          "type": "integer",
          "required": false,
          "constraints": [],
          "note": "Minimum number of active job postings. Pair with organization_num_jobs_range[max]."
        },
        {
          "name": "organization_num_jobs_range[max]",
          "location": "queryParams",
          "type": "integer",
          "required": false,
          "constraints": [],
          "note": "Maximum number of active job postings."
        },
        {
          "name": "organization_job_posted_at_range[min]",
          "location": "queryParams",
          "type": "string",
          "required": false,
          "constraints": [],
          "note": "Earliest date the company posted jobs, YYYY-MM-DD. Pair with organization_job_posted_at_range[max]."
        },
        {
          "name": "organization_job_posted_at_range[max]",
          "location": "queryParams",
          "type": "string",
          "required": false,
          "constraints": [],
          "note": "Latest date the company posted jobs, YYYY-MM-DD."
        },
        {
          "name": "organization_headcount_growth_past_n_months",
          "location": "queryParams",
          "type": "integer",
          "required": false,
          "constraints": [
            "one of 6, 12, 24"
          ],
          "note": "Trailing window in months for headcount growth. Has no effect unless sent with organization_headcount_growth_range[min] or [max]."
        },
        {
          "name": "organization_headcount_growth_range[min]",
          "location": "queryParams",
          "type": "integer",
          "required": false,
          "constraints": [],
          "note": "Minimum headcount growth as a whole-number percentage over the window; 10 means 10%. Needs organization_headcount_growth_past_n_months."
        },
        {
          "name": "organization_headcount_growth_range[max]",
          "location": "queryParams",
          "type": "integer",
          "required": false,
          "constraints": [],
          "note": "Maximum headcount growth as a whole-number percentage over the window. Needs organization_headcount_growth_past_n_months."
        },
        {
          "name": "lookalike_organization_ids[]",
          "location": "queryParams",
          "type": "array",
          "required": false,
          "constraints": [
            "at most 5"
          ],
          "note": "Apollo IDs of up to 5 seed companies; results are narrowed and ranked by similarity and exclude the seeds."
        },
        {
          "name": "not_organization_websites_list[]",
          "location": "queryParams",
          "type": "array",
          "required": false,
          "constraints": [],
          "note": "Exclude companies that match any of these domains, including the company's other known domains."
        },
        {
          "name": "page",
          "location": "queryParams",
          "type": "integer",
          "required": false,
          "constraints": [
            "1 to 500"
          ],
          "note": "Page to return, up to 500 pages of 100; use with per_page. Each page costs 1 credit."
        },
        {
          "name": "per_page",
          "location": "queryParams",
          "type": "integer",
          "required": false,
          "constraints": [
            "1 to 100"
          ],
          "note": "Results per page, up to 100. Apollo caps a search at 50,000 records."
        }
      ],
      "sampleInput": {
        "q_organization_domains_list[]": [
          "stripe.com"
        ],
        "per_page": 1
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "q_organization_domains_list[]": {
            "type": "array",
            "description": "Company domains, without www. or @; up to 1,000. Examples: apollo.io; microsoft.com.",
            "examples": [
              [
                "stripe.com"
              ]
            ],
            "maxItems": 1000
          },
          "organization_num_employees_ranges[]": {
            "type": "array",
            "description": "Headcount ranges as lower,upper strings. Examples: 1,10; 250,500; 10000,20000."
          },
          "organization_locations[]": {
            "type": "array",
            "description": "Headquarters location: cities, US states or countries. Examples: texas; tokyo; spain."
          },
          "organization_not_locations[]": {
            "type": "array",
            "description": "Exclude companies by headquarters location: cities, US states or countries. Examples: minnesota; ireland."
          },
          "revenue_range[min]": {
            "type": "integer",
            "description": "Minimum revenue, digits only (no currency symbol, comma or decimal point). Pair with revenue_range[max]."
          },
          "revenue_range[max]": {
            "type": "integer",
            "description": "Maximum revenue, digits only. Pair with revenue_range[min]."
          },
          "currently_using_any_of_technology_uids[]": {
            "type": "array",
            "description": "Company must use any of these. Technology uids; replace spaces and periods with underscores. Apollo filters on 1,500+ technologies. Examples: salesforce; google_analytics; wordpress_org."
          },
          "q_organization_keyword_tags[]": {
            "type": "array",
            "description": "Keywords associated with companies. Examples: mining; sales strategy; consulting."
          },
          "q_organization_name": {
            "type": "string",
            "description": "Company name; partial matches are accepted, so marketing matches NY Marketing Unlimited."
          },
          "organization_ids[]": {
            "type": "array",
            "description": "Apollo IDs of companies to include; this route returns them as id."
          },
          "latest_funding_amount_range[min]": {
            "type": "integer",
            "description": "Minimum amount of the most recent funding round, digits only. Pair with latest_funding_amount_range[max]."
          },
          "latest_funding_amount_range[max]": {
            "type": "integer",
            "description": "Maximum amount of the most recent funding round, digits only."
          },
          "total_funding_range[min]": {
            "type": "integer",
            "description": "Minimum total funding across all rounds, digits only. Pair with total_funding_range[max]."
          },
          "total_funding_range[max]": {
            "type": "integer",
            "description": "Maximum total funding across all rounds, digits only."
          },
          "latest_funding_date_range[min]": {
            "type": "string",
            "description": "Earliest date of the most recent funding round, YYYY-MM-DD. Pair with latest_funding_date_range[max].",
            "examples": [
              "2025-07-25"
            ]
          },
          "latest_funding_date_range[max]": {
            "type": "string",
            "description": "Latest date of the most recent funding round, YYYY-MM-DD.",
            "examples": [
              "2025-09-25"
            ]
          },
          "q_organization_job_titles[]": {
            "type": "array",
            "description": "Job titles in the company's active job postings. Examples: sales manager; research analyst."
          },
          "organization_job_locations[]": {
            "type": "array",
            "description": "Locations of the jobs the company is recruiting for. Examples: atlanta; japan."
          },
          "organization_num_jobs_range[min]": {
            "type": "integer",
            "description": "Minimum number of active job postings. Pair with organization_num_jobs_range[max]."
          },
          "organization_num_jobs_range[max]": {
            "type": "integer",
            "description": "Maximum number of active job postings."
          },
          "organization_job_posted_at_range[min]": {
            "type": "string",
            "description": "Earliest date the company posted jobs, YYYY-MM-DD. Pair with organization_job_posted_at_range[max].",
            "examples": [
              "2025-07-25"
            ]
          },
          "organization_job_posted_at_range[max]": {
            "type": "string",
            "description": "Latest date the company posted jobs, YYYY-MM-DD.",
            "examples": [
              "2025-09-25"
            ]
          },
          "organization_headcount_growth_past_n_months": {
            "type": "integer",
            "description": "Trailing window in months for headcount growth. Has no effect unless sent with organization_headcount_growth_range[min] or [max].",
            "enum": [
              6,
              12,
              24
            ]
          },
          "organization_headcount_growth_range[min]": {
            "type": "integer",
            "description": "Minimum headcount growth as a whole-number percentage over the window; 10 means 10%. Needs organization_headcount_growth_past_n_months."
          },
          "organization_headcount_growth_range[max]": {
            "type": "integer",
            "description": "Maximum headcount growth as a whole-number percentage over the window. Needs organization_headcount_growth_past_n_months."
          },
          "lookalike_organization_ids[]": {
            "type": "array",
            "description": "Apollo IDs of up to 5 seed companies; results are narrowed and ranked by similarity and exclude the seeds.",
            "maxItems": 5
          },
          "not_organization_websites_list[]": {
            "type": "array",
            "description": "Exclude companies that match any of these domains, including the company's other known domains."
          },
          "page": {
            "type": "integer",
            "description": "Page to return, up to 500 pages of 100; use with per_page. Each page costs 1 credit.",
            "examples": [
              1
            ],
            "minimum": 1,
            "maximum": 500
          },
          "per_page": {
            "type": "integer",
            "description": "Results per page, up to 100. Apollo caps a search at 50,000 records.",
            "examples": [
              10
            ],
            "minimum": 1,
            "maximum": 100
          }
        },
        "additionalProperties": false
      },
      "output": [
        {
          "name": "pagination",
          "type": "object"
        },
        {
          "name": "partial_results_only",
          "type": "boolean"
        },
        {
          "name": "partial_results_limit",
          "type": "integer"
        },
        {
          "name": "organizations",
          "type": "object[]"
        },
        {
          "name": "accounts",
          "type": "any[]"
        }
      ],
      "outputSchema": {
        "type": "object",
        "properties": {
          "pagination": {
            "type": "object",
            "properties": {
              "page": {
                "type": "integer"
              },
              "per_page": {
                "type": "integer"
              },
              "total_entries": {
                "type": "integer"
              },
              "total_pages": {
                "type": "integer"
              }
            }
          },
          "partial_results_only": {
            "type": "boolean"
          },
          "partial_results_limit": {
            "type": "integer"
          },
          "organizations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "website_url": {
                  "type": "string"
                },
                "linkedin_url": {
                  "type": "string"
                },
                "twitter_url": {
                  "type": "string"
                },
                "facebook_url": {
                  "type": "string"
                },
                "primary_domain": {
                  "type": "string"
                },
                "founded_year": {
                  "type": "integer"
                },
                "alexa_ranking": {
                  "type": "integer"
                },
                "logo_url": {
                  "type": "string"
                },
                "languages": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "phone": {
                  "type": "string"
                }
              }
            }
          },
          "accounts": {
            "type": "array"
          }
        }
      },
      "commands": {
        "mode": "run",
        "cli": "telipot run apollo.company.search \\\n  --input-json '{\"q_organization_domains_list[]\":[\"stripe.com\"],\"per_page\":1}'",
        "http": "curl https://api.telipot.com/v1/tasks/apollo.company.search/run \\\n  -H \"Authorization: Bearer $TELIPOT_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"q_organization_domains_list[]\":[\"stripe.com\"],\"per_page\":1}'",
        "quote": "telipot run apollo.company.search \\\n  --input-json '{\"q_organization_domains_list[]\":[\"stripe.com\"],\"per_page\":1}' \\\n  --quote"
      },
      "siblings": [
        {
          "id": "hunter.company.search",
          "name": "Companies by industry, headcount, location and keywords",
          "provider": {
            "slug": "hunter",
            "name": "Hunter"
          },
          "capability": "company.search",
          "platform": "company",
          "kind": "data",
          "tier": "core",
          "identity": "key",
          "identityLabel": "Your plan",
          "price": {
            "amount": "Free",
            "state": "free",
            "label": "Free",
            "detail": "Free from the tool",
            "type": "free"
          },
          "providers": 2,
          "retention": "standard",
          "runsOn": "free",
          "live": true
        }
      ]
    }
  ]
}
