{
  "url": "https://telipot.com/catalog/tasks/apollo.company.search",
  "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
    }
  ]
}