# apollo.company.search

Companies by domain, size, location, funding, tech filters

> Use the organization search endpoint to find companies in the Apollo database.

Page: https://telipot.com/catalog/tasks/apollo.company.search · Markdown: https://telipot.com/catalog/tasks/apollo.company.search/md · JSON: https://telipot.com/catalog/tasks/apollo.company.search/json

| Field | Value |
| --- | --- |
| provider | [Apollo](https://telipot.com/catalog/providers/apollo) `apollo` |
| capability | [`company.search`](https://telipot.com/catalog/capabilities/company.search) |
| kind | data |
| tier | core |
| price | $0.0196 / call (1 credit · docs) |
| price note | 1 credit per page, up to 100 results per page; per_page does not change the charge. |
| identity | Your plan |
| auth | `api_key · in header as x-api-key` |
| scope | any_account |
| principal | organization |
| required_scopes | none |
| retention | standard |
| route | `POST https://api.apollo.io/api/v1/mixed_companies/search` |
| verification | Not verified yet. Not checked yet. We test with a real request before we mark it. |
| status | live |
| docs | https://docs.apollo.io/reference/organization-search |

## Preview the price · nothing runs

```bash
telipot run apollo.company.search \
  --input-json '{"q_organization_domains_list[]":["stripe.com"],"per_page":1}' \
  --quote
```

## Run it

```bash
telipot run apollo.company.search \
  --input-json '{"q_organization_domains_list[]":["stripe.com"],"per_page":1}'
```

```bash
curl https://api.telipot.com/v1/tasks/apollo.company.search/run \
  -H "Authorization: Bearer $TELIPOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"q_organization_domains_list[]":["stripe.com"],"per_page":1}'
```

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `q_organization_domains_list[]` | queryParams | array | no | at most 1000 | Company domains, without www. or @; up to 1,000. Examples: apollo.io; microsoft.com. |
| `organization_num_employees_ranges[]` | queryParams | array | no |  | Headcount ranges as lower,upper strings. Examples: 1,10; 250,500; 10000,20000. |
| `organization_locations[]` | queryParams | array | no |  | Headquarters location: cities, US states or countries. Examples: texas; tokyo; spain. |
| `organization_not_locations[]` | queryParams | array | no |  | Exclude companies by headquarters location: cities, US states or countries. Examples: minnesota; ireland. |
| `revenue_range[min]` | queryParams | integer | no |  | Minimum revenue, digits only (no currency symbol, comma or decimal point). Pair with revenue_range[max]. |
| `revenue_range[max]` | queryParams | integer | no |  | Maximum revenue, digits only. Pair with revenue_range[min]. |
| `currently_using_any_of_technology_uids[]` | queryParams | array | no |  | 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[]` | queryParams | array | no |  | Keywords associated with companies. Examples: mining; sales strategy; consulting. |
| `q_organization_name` | queryParams | string | no |  | Company name; partial matches are accepted, so marketing matches NY Marketing Unlimited. |
| `organization_ids[]` | queryParams | array | no |  | Apollo IDs of companies to include; this route returns them as id. |
| `latest_funding_amount_range[min]` | queryParams | integer | no |  | Minimum amount of the most recent funding round, digits only. Pair with latest_funding_amount_range[max]. |
| `latest_funding_amount_range[max]` | queryParams | integer | no |  | Maximum amount of the most recent funding round, digits only. |
| `total_funding_range[min]` | queryParams | integer | no |  | Minimum total funding across all rounds, digits only. Pair with total_funding_range[max]. |
| `total_funding_range[max]` | queryParams | integer | no |  | Maximum total funding across all rounds, digits only. |
| `latest_funding_date_range[min]` | queryParams | string | no |  | Earliest date of the most recent funding round, YYYY-MM-DD. Pair with latest_funding_date_range[max]. |
| `latest_funding_date_range[max]` | queryParams | string | no |  | Latest date of the most recent funding round, YYYY-MM-DD. |
| `q_organization_job_titles[]` | queryParams | array | no |  | Job titles in the company's active job postings. Examples: sales manager; research analyst. |
| `organization_job_locations[]` | queryParams | array | no |  | Locations of the jobs the company is recruiting for. Examples: atlanta; japan. |
| `organization_num_jobs_range[min]` | queryParams | integer | no |  | Minimum number of active job postings. Pair with organization_num_jobs_range[max]. |
| `organization_num_jobs_range[max]` | queryParams | integer | no |  | Maximum number of active job postings. |
| `organization_job_posted_at_range[min]` | queryParams | string | no |  | Earliest date the company posted jobs, YYYY-MM-DD. Pair with organization_job_posted_at_range[max]. |
| `organization_job_posted_at_range[max]` | queryParams | string | no |  | Latest date the company posted jobs, YYYY-MM-DD. |
| `organization_headcount_growth_past_n_months` | queryParams | integer | no | one of 6, 12, 24 | Trailing window in months for headcount growth. Has no effect unless sent with organization_headcount_growth_range[min] or [max]. |
| `organization_headcount_growth_range[min]` | queryParams | integer | no |  | 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]` | queryParams | integer | no |  | Maximum headcount growth as a whole-number percentage over the window. Needs organization_headcount_growth_past_n_months. |
| `lookalike_organization_ids[]` | queryParams | array | no | at most 5 | Apollo IDs of up to 5 seed companies; results are narrowed and ranked by similarity and exclude the seeds. |
| `not_organization_websites_list[]` | queryParams | array | no |  | Exclude companies that match any of these domains, including the company's other known domains. |
| `page` | queryParams | integer | no | 1 to 500 | Page to return, up to 500 pages of 100; use with per_page. Each page costs 1 credit. |
| `per_page` | queryParams | integer | no | 1 to 100 | Results per page, up to 100. Apollo caps a search at 50,000 records. |

## Input schema

```json
{
  "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 schema

```json
{
  "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"
    }
  }
}
```

## Other tools for this job

- [`hunter.company.search`](https://telipot.com/catalog/tasks/hunter.company.search) · Free