# Organization Search
Use the Organization Search endpoint to find companies in the Apollo database. Several filters are available to help narrow your search.
Calling this endpoint does consume credits as part of your Apollo pricing plan.
To protect Apollo's performance for all users, this endpoint has a display limit of 50,000 records (100 records per page, up to 500 pages). Add more filters to narrow your search results as much as possible. This limitation does not restrict your access to Apollo's database; you just need to access the data in batches.
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "apollo-rest-api",
"version": "1.0"
},
"servers": [
{
"url": "https://api.apollo.io/api/v1"
}
],
"components": {
"securitySchemes": {
"apiKey": {
"type": "apiKey",
"in": "header",
"name": "x-api-key",
"description": "API key"
},
"bearerAuth": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "JWT",
"description": "[Recommended] OAuth Access token"
}
}
},
"security": [
{
"bearerAuth": []
},
{
"apiKey": []
}
],
"paths": {
"/mixed_companies/search": {
"post": {
"summary": "Organization Search",
"description": "Use the Organization Search endpoint to find companies in the Apollo database. Several filters are available to help narrow your search.
Calling this endpoint does consume credits as part of your Apollo pricing plan.
To protect Apollo's performance for all users, this endpoint has a display limit of 50,000 records (100 records per page, up to 500 pages). Add more filters to narrow your search results as much as possible. This limitation does not restrict your access to Apollo's database; you just need to access the data in batches.",
"operationId": "organization-search",
"parameters": [
{
"name": "q_organization_domains_list[]",
"in": "query",
"required": false,
"description": "The domain name for the person's employer. This can be the current employer or a previous employer. Do not include `www.`, the `@` symbol, or similar.
This parameter accepts up to 1,000 domains in a single request.
Examples: `apollo.io`; `microsoft.com`",
"schema": {
"type": "array",
"default": "",
"items": {
"type": "string"
}
}
},
{
"name": "organization_num_employees_ranges[]",
"in": "query",
"description": "The number range of employees working for the company. This enables you to find companies based on headcount. You can add multiple ranges to expand your search results.
Each range you add needs to be a string, with the upper and lower numbers of the range separated only by a comma.
Examples: `1,10`; `250,500`; `10000,20000`",
"schema": {
"type": "array",
"items": {
"type": "string"
}
}
},
{
"name": "organization_locations[]",
"in": "query",
"description": "The location of the company headquarters. You can search across cities, US states, and countries.
If a company has several office locations, results are still based on the headquarters location. For example, if you search `chicago` but a company's HQ location is in `boston`, any Boston-based companies will not appearch in your search results, even if they match other parameters..
To exclude companies based on location, use the `organization_not_locations` parameter.
Examples: `texas`; `tokyo`; `spain`",
"schema": {
"type": "array",
"items": {
"type": "string"
}
}
},
{
"name": "organization_not_locations[]",
"in": "query",
"description": "Exclude companies from search results based on the location of the company headquarters. You can use cities, US states, and countries as locations to exclude.
This parameter is useful for ensuring you do not prospect in an undesirable territory. For example, if you use `ireland` as a value, no Ireland-based companies will appear in your search results.
Examples: `minnesota`; `ireland`; `seoul`",
"schema": {
"type": "array",
"items": {
"type": "string"
}
}
},
{
"name": "revenue_range[min]",
"in": "query",
"description": "Search for organizations based on their revenue.
Use this parameter to set the lower range of organization revenue. Use the `revenue_range[max]` parameter to set the upper range of revenue.
Do not enter currency symbols, commas, or decimal points in the figure.
Example: `300000`",
"schema": {
"type": "integer"
}
},
{
"name": "revenue_range[max]",
"in": "query",
"description": "Search for organizations based on their revenue.
Use this parameter to set the upper range of organization revenue. Use the `revenue_range[min]` parameter to set the lower range of revenue.
Do not enter currency symbols, commas, or decimal points in the figure.
Example: `50000000`",
"schema": {
"type": "integer"
}
},
{
"name": "currently_using_any_of_technology_uids[]",
"in": "query",
"description": "Find organizations based on the technologies they currently use. Apollo supports filtering by 1,500+ technologies.
Apollo calculates technologies data from multiple sources. This data is updated regularly. Check out the full list of supported technologies by downloading this CSV file.
Use underscores (`_`) to replace spaces and periods for the technologies listed in the CSV file.
Examples: `salesforce`; `google_analytics`; `wordpress_org`",
"schema": {
"type": "array",
"items": {
"type": "string"
}
}
},
{
"name": "q_organization_keyword_tags[]",
"in": "query",
"description": "Filter search results based on keywords associated with companies. For example, you can enter `mining` as a value to return only companies that have an association with the mining industry.
Examples: `mining`; `sales strategy`; `consulting`",
"schema": {
"type": "array",
"items": {
"type": "string"
}
}
},
{
"name": "q_organization_name",
"in": "query",
"description": "Filter search results to include a specific company name.
If the value you enter for this parameter does not match with a company's name, the company will not appear in search results, even if it matches other parameters. Partial matches are accepted. For example, if you filter by the value `marketing`, a company called `NY Marketing Unlimited` would still be eligible as a search result, but `NY Market Analysis` would not be eligible.
Example: `apollo` or `mining`",
"schema": {
"type": "string"
}
},
{
"name": "organization_ids[]",
"in": "query",
"description": "The Apollo IDs for the companies you want to include in your search results. Each company in the Apollo database is assigned a unique ID.
To find IDs, identify the values for `organization_id` when you call this endpoint.
Example: `5e66b6381e05b4008c8331b8`",
"schema": {
"type": "array",
"items": {
"type": "string"
}
}
},
{
"name": "latest_funding_amount_range[min]",
"in": "query",
"required": false,
"description": "The minimum amount the company received with its most recent funding round. Use this parameter in combination with `latest_funding_amount_range[max]` to set a monetary range for the company's most recent funding round.
Do not enter currency symbols, commas, or decimal points in the figure.
Examples: `5000000`; `15000000`",
"schema": {
"type": "integer",
"default": ""
}
},
{
"name": "latest_funding_amount_range[max]",
"in": "query",
"required": false,
"description": "The maximium amount the company received with its most recent funding round. Use this parameter in combination with `latest_funding_amount_range[min]` to set a monetary range for the company's most recent funding round.
Do not enter currency symbols, commas, or decimal points in the figure.
Examples: `5000000`; `15000000`",
"schema": {
"type": "integer",
"default": ""
}
},
{
"name": "total_funding_range[min]",
"in": "query",
"required": false,
"description": "The minimum amount the company received during all of its funding rounds combined. Use this parameter in combination with `total_funding_range[max]` to set a monetary range for all of the company's funding rounds.
Do not enter currency symbols, commas, or decimal points in the figure.
Examples: `50000000`; `350000000`",
"schema": {
"type": "integer",
"default": ""
}
},
{
"name": "total_funding_range[max]",
"in": "query",
"required": false,
"description": "The maximum amount the company received during all of its funding rounds combined. Use this parameter in combination with `total_funding_range[min]` to set a monetary range for all of the company's funding rounds.
Do not enter currency symbols, commas, or decimal points in the figure.
Examples: `50000000`; `350000000`",
"schema": {
"type": "integer",
"default": ""
}
},
{
"name": "latest_funding_date_range[min]",
"in": "query",
"required": false,
"description": "The earliest date when the company received its most recent funding round. Use this parameter in combination with `latest_funding_date_range[max]` to set a date range for when the company received its most recent funding round.
Example: `2025-07-25`",
"schema": {
"type": "string",
"format": "date",
"default": ""
}
},
{
"name": "latest_funding_date_range[max]",
"in": "query",
"required": false,
"description": "The latest date when the company received its most recent funding round. Use this parameter in combination with `latest_funding_date_range[min]` to set a date range for when the company received its most recent funding round.
Example: `2025-09-25`",
"schema": {
"type": "string",
"format": "date",
"default": ""
}
},
{
"name": "q_organization_job_titles[]",
"in": "query",
"required": false,
"description": "The job titles that are listed in active job postings at the company.
Examples: `sales manager`; `research analyst`",
"schema": {
"type": "array",
"default": "",
"items": {
"type": "string"
}
}
},
{
"name": "organization_job_locations[]",
"in": "query",
"required": false,
"description": "The locations of the jobs being actively recruited by the company.
Examples: `atlanta`; `japan`",
"schema": {
"type": "array",
"default": "",
"items": {
"type": "string"
}
}
},
{
"name": "organization_num_jobs_range[min]",
"in": "query",
"required": false,
"description": "The minimum number of job postings active at the company. Use this parameter in combination with `organization_num_jobs_range[max]` to set a job postings range.
Examples: `50`; `500`",
"schema": {
"type": "integer",
"default": ""
}
},
{
"name": "organization_num_jobs_range[max]",
"in": "query",
"required": false,
"description": "The maximum number of job postings active at the company. Use this parameter in combination with `organization_num_jobs_range[min]` to set a job postings range.
Examples: `50`; `500`",
"schema": {
"type": "integer",
"default": ""
}
},
{
"name": "organization_job_posted_at_range[min]",
"in": "query",
"required": false,
"description": "The earliest date when jobs were posted by the company. Use this parameter in combination with `organization_job_posted_at_range[max]` to set a date range for when jobs posted.
Example: `2025-07-25`",
"schema": {
"type": "string",
"format": "date",
"default": ""
}
},
{
"name": "organization_job_posted_at_range[max]",
"in": "query",
"required": false,
"description": "The latest date when jobs were posted by the company. Use this parameter in combination with `organization_job_posted_at_range[min]` to set a date range for when jobs posted.
Example: `2025-09-25`",
"schema": {
"type": "string",
"format": "date",
"default": ""
}
},
{
"name": "page",
"in": "query",
"description": "The page number of the Apollo data that you want to retrieve.
Use this parameter in combination with the `per_page` parameter to make search results for navigable and improve the performance of the endpoint.
Example: `4`",
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "per_page",
"in": "query",
"description": "The number of search results that should be returned for each page. Limiting the number of results per page improves the endpoint's performance.
Use the `page` parameter to search the different pages of data.
Example: `10`",
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": {
"breadcrumbs": [
{
"label": "# Employees",
"signal_field_name": "organization_num_employees_ranges",
"value": "250,1000",
"display_name": "250-1000"
},
{
"label": "# Employees",
"signal_field_name": "organization_num_employees_ranges",
"value": "5000,10000",
"display_name": "5000-10000"
},
{
"label": "Company Locations",
"signal_field_name": "organization_locations",
"value": "japan",
"display_name": "japan"
},
{
"label": "Company Locations",
"signal_field_name": "organization_locations",
"value": "ireland",
"display_name": "ireland"
}
],
"partial_results_only": false,
"has_join": false,
"disable_eu_prospecting": false,
"partial_results_limit": 10000,
"pagination": {
"page": 1,
"per_page": 2,
"total_entries": 1184,
"total_pages": 592
},
"accounts": [],
"organizations": [
{
"id": "615d029256de500001bdb460",
"name": "Nikkei Asia",
"website_url": "http://www.nikkei.com",
"blog_url": null,
"angellist_url": null,
"linkedin_url": "http://www.linkedin.com/company/nikkeiasia",
"twitter_url": "https://twitter.com/nikkei",
"facebook_url": "https://facebook.com/nikkei",
"primary_phone": {
"number": "+81 362-56-2793",
"source": "Scraped",
"sanitized_number": "+81362562793"
},
"languages": [
"Japanese",
"Chinese"
],
"alexa_ranking": 1583,
"phone": "+81 362-56-2793",
"linkedin_uid": "3335963",
"founded_year": 1876,
"publicly_traded_symbol": null,
"publicly_traded_exchange": null,
"logo_url": "https://zenprospect-production.s3.amazonaws.com/uploads/pictures/66de78ba1ad1eb00018e27a5/picture",
"crunchbase_url": null,
"primary_domain": "nikkei.com",
"sanitized_phone": "+81362562793",
"owned_by_organization_id": null,
"intent_strength": null,
"show_intent": true,
"has_intent_signal_account": false,
"intent_signal_account": null
},
{
"id": "55f1fcddf3e5bb0be2000a92",
"name": "Mitsui & Co., Ltd.",
"website_url": "http://www.mitsui.com",
"blog_url": null,
"angellist_url": null,
"linkedin_url": "http://www.linkedin.com/company/mitsui-co-ltd-",
"twitter_url": "https://twitter.com/citra_citrasa",
"facebook_url": "https://facebook.com/mitsuiandco/",
"primary_phone": {
"number": "+81 3328-5-1111",
"source": "Owler",
"sanitized_number": "+81332851111"
},
"languages": [],
"alexa_ranking": 265731,
"phone": "+81 3328-5-1111",
"linkedin_uid": "6675",
"founded_year": 1947,
"publicly_traded_symbol": "8031",
"publicly_traded_exchange": "tyo",
"logo_url": "https://zenprospect-production.s3.amazonaws.com/uploads/pictures/66da87a3b12bcc0001042a77/picture",
"crunchbase_url": null,
"primary_domain": "mitsui.com",
"sanitized_phone": "+81332851111",
"owned_by_organization_id": null,
"intent_strength": null,
"show_intent": true,
"has_intent_signal_account": false,
"intent_signal_account": null
}
],
"model_ids": [
"615d029256de500001bdb460",
"55f1fcddf3e5bb0be2000a92"
],
"num_fetch_result": null,
"derived_params": null
}
}
},
"schema": {
"type": "object",
"properties": {
"breadcrumbs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"example": "# Employees"
},
"signal_field_name": {
"type": "string",
"example": "organization_num_employees_ranges"
},
"value": {
"type": "string",
"example": "250,1000"
},
"display_name": {
"type": "string",
"example": "250-1000"
}
}
}
},
"partial_results_only": {
"type": "boolean",
"example": false,
"default": true
},
"has_join": {
"type": "boolean",
"example": false,
"default": true
},
"disable_eu_prospecting": {
"type": "boolean",
"example": false,
"default": true
},
"partial_results_limit": {
"type": "integer",
"example": 10000,
"default": 0
},
"pagination": {
"type": "object",
"properties": {
"page": {
"type": "integer",
"example": 1,
"default": 0
},
"per_page": {
"type": "integer",
"example": 2,
"default": 0
},
"total_entries": {
"type": "integer",
"example": 1184,
"default": 0
},
"total_pages": {
"type": "integer",
"example": 592,
"default": 0
}
}
},
"accounts": {
"type": "array"
},
"organizations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "615d029256de500001bdb460"
},
"name": {
"type": "string",
"example": "Nikkei Asia"
},
"website_url": {
"type": "string",
"example": "http://www.nikkei.com"
},
"blog_url": {},
"angellist_url": {},
"linkedin_url": {
"type": "string",
"example": "http://www.linkedin.com/company/nikkeiasia"
},
"twitter_url": {
"type": "string",
"example": "https://twitter.com/nikkei"
},
"facebook_url": {
"type": "string",
"example": "https://facebook.com/nikkei"
},
"primary_phone": {
"type": "object",
"properties": {
"number": {
"type": "string",
"example": "+81 362-56-2793"
},
"source": {
"type": "string",
"example": "Scraped"
},
"sanitized_number": {
"type": "string",
"example": "+81362562793"
}
}
},
"languages": {
"type": "array",
"items": {
"type": "string",
"example": "Japanese"
}
},
"alexa_ranking": {
"type": "integer",
"example": 1583,
"default": 0
},
"phone": {
"type": "string",
"example": "+81 362-56-2793"
},
"linkedin_uid": {
"type": "string",
"example": "3335963"
},
"founded_year": {
"type": "integer",
"example": 1876,
"default": 0
},
"publicly_traded_symbol": {},
"publicly_traded_exchange": {},
"logo_url": {
"type": "string",
"example": "https://zenprospect-production.s3.amazonaws.com/uploads/pictures/66de78ba1ad1eb00018e27a5/picture"
},
"crunchbase_url": {},
"primary_domain": {
"type": "string",
"example": "nikkei.com"
},
"sanitized_phone": {
"type": "string",
"example": "+81362562793"
},
"owned_by_organization_id": {},
"intent_strength": {},
"show_intent": {
"type": "boolean",
"example": true,
"default": true
},
"has_intent_signal_account": {
"type": "boolean",
"example": false,
"default": true
},
"intent_signal_account": {}
}
}
},
"model_ids": {
"type": "array",
"items": {
"type": "string",
"example": "615d029256de500001bdb460"
}
},
"num_fetch_result": {},
"derived_params": {}
}
}
}
}
},
"401": {
"description": "401",
"content": {
"text/plain": {
"examples": {
"Check API key": {
"value": "Invalid access credentials."
}
}
}
}
},
"403": {
"description": "403",
"content": {
"application/json": {
"examples": {
"Check Apollo pricing plan": {
"value": "{\n \"message\": \"This endpoint is only available to Apollo users on paid plans.\"\n}"
}
},
"schema": {
"type": "object",
"properties": {
"message": {
"type": "string",
"example": "This endpoint is only available to Apollo users on paid plans."
}
}
}
}
}
},
"429": {
"description": "429",
"content": {
"application/json": {
"examples": {
"Too many requests": {
"value": "{\n \"message\": \"The maximum number of api calls allowed for api/v1/mixed_companies/search is 600 times per hour. Please upgrade your plan from https://app.apollo.io/#/settings/plans/upgrade.\"\n}"
}
},
"schema": {
"type": "object",
"properties": {
"message": {
"type": "string",
"example": "The maximum number of api calls allowed for api/v1/mixed_companies/search is 600 times per hour. Please upgrade your plan from https://app.apollo.io/#/settings/plans/upgrade."
}
}
}
}
}
}
},
"deprecated": false
}
}
},
"x-readme": {
"headers": [
{
"key": "Cache-Control",
"value": "no-cache"
},
{
"key": "Content-Type",
"value": "application/json"
}
],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```