--- updatedAt: 2026-09-29T14:39:45.000Z agentTools: projectIndex: https://docs.apollo.io/llms.txt --- # Organization Search
Endpoint essentials
API key access api/v1/mixed_companies/search or Master API key
OAuth scopes mixed_companies_search
Account access Requires an Apollo account registered with a work email address. Additional account eligibility requirements may apply. Paid accounts aren't affected.
Credit usage 1 credit per page
This endpoint consumes 1 Apollo credit per page, with up to 100 results per page. Learn more about API pricing and credits.
Organizations are companies you haven't yet saved as accounts on Apollo.

Use the organization search endpoint to find companies in the Apollo database. Several filters are available to help narrow your search.

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. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "apollo-rest-api", "summary": "Programmatic access to Apollo's sales intelligence and engagement platform — data enrichment, prospect and company search, and go-to-market workflow management.", "description": "The Apollo API provides programmatic access to [Apollo](https://www.apollo.io/), the all-in-one sales intelligence and engagement platform. Use it to enrich people and company data (individually or in bulk), search Apollo's database of over 240 million contacts and 30 million companies, and manage accounts, contacts, deals, sequences, tasks, calls, and conversations in your go-to-market workflows.\n\n## Base URL\n\nAll API requests are made to `https://api.apollo.io/api/v1`.\n\n## Authentication\n\n- **Apollo users** authenticate with an API key passed in the `x-api-key` request header. See [Create API Keys](https://docs.apollo.io/docs/create-api-key).\n- **Apollo partners** building integrations on behalf of mutual users authenticate with the [OAuth 2.0 authorization flow](https://docs.apollo.io/docs/use-oauth-20-authorization-flow-to-access-apollo-user-information-partners).\n\n## Rate limits & credits\n\nRate limits and credit consumption depend on your [Apollo pricing plan](https://docs.apollo.io/docs/api-pricing). Check your current limits and usage with the [view API usage stats and rate limits](https://docs.apollo.io/reference/view-api-usage-stats) endpoint. For more details, see [Rate Limits](https://docs.apollo.io/reference/rate-limits) and the [API FAQs](https://docs.apollo.io/docs/apollo-api-faqs).\n\nNew to the API? Start with the [Apollo API overview](https://docs.apollo.io/reference/apollo-api).", "termsOfService": "https://www.apollo.io/terms/api", "contact": { "name": "Apollo API Support", "url": "https://docs.apollo.io/" }, "version": "1.0" }, "servers": [ { "url": "https://api.apollo.io/api/v1" } ], "tags": [ { "name": "Search", "description": "Search Apollo's database of people, companies, news articles, and job postings." } ], "components": { "securitySchemes": { "apiKey": { "type": "apiKey", "in": "header", "name": "x-api-key", "description": "[Recommended] API key, passed in the `x-api-key` request header.\nSee [Create API Keys](https://docs.apollo.io/docs/create-api-key)." }, "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT", "description": "OAuth 2.0 access token, used by Apollo partners building integrations.\nSee the [OAuth 2.0 authorization flow](https://docs.apollo.io/docs/use-oauth-20-authorization-flow-to-access-apollo-user-information-partners)." } }, "schemas": { "ErrorDetails": { "type": "object", "description": "Machine-readable detail for an error that uses the new format, returned alongside the endpoint's existing error fields. The legacy error fields at the root level (`error`, `error_code`, `message`, etc) are removed on 2027-02-16, after which `error_details` is the only error payload. Some errors already return `error_details` on its own.", "properties": { "code": { "type": "string", "description": "Stable identifier in the form `DOMAIN.CATEGORY.REASON`. Branch on this value; the human-readable `message` can change.", "example": "AUTH.AUTHENTICATION.CREDENTIALS_MISSING" }, "message": { "type": "string", "description": "Human-readable explanation of what went wrong.", "example": "This request carried no credential Apollo could authenticate." }, "suggestions": { "type": "array", "description": "Ordered, actionable next steps. Each entry carries a `label`, and where relevant the `parameter`, `header`, or `url` it refers to.", "items": { "type": "object", "properties": { "label": { "type": "string", "example": "Send your API key in the X-Api-Key header" }, "url": { "type": "string", "example": "https://docs.apollo.io/reference/authentication" }, "parameter": { "type": "string", "example": "webhook_url" }, "parameters": { "type": "array", "description": "Several parameters, any one of which satisfies the requirement.", "items": { "type": "string" }, "example": [ "name", "domain", "website_url", "linkedin_url" ] }, "header": { "type": "string", "example": "X-Api-Key" }, "example": { "type": "string", "description": "A valid sample value for the parameter named above." }, "retry_after_seconds": { "type": "integer", "description": "On a rate-limit refusal, how long to wait before retrying.", "example": 60 } } } }, "context": { "type": "object", "description": "Values from your request that explain the refusal. Each entry is an object rather than a bare value, so read `context..value`. Absent when the error needs no context.", "additionalProperties": { "type": "object", "properties": { "value": { "type": "string" }, "description": { "type": "string" } } }, "example": { "window": { "value": "hourly", "description": "The rate-limit window your request exceeded" } } } } } } }, "security": [ { "apiKey": [] }, { "bearerAuth": [] } ], "paths": { "/mixed_companies/search": { "post": { "summary": "Organization search", "description": "## Endpoint essentials\n\n**API key access:** `api/v1/mixed_companies/search` or `Master API key`\n\n**OAuth scopes:** `mixed_companies_search`\n\n**Free account access:** Requires an Apollo account registered with a work email address. Additional account eligibility requirements may apply. Paid accounts aren't affected.\n\n**Credit usage:** `1 credit per page`\n\nThis endpoint consumes 1 Apollo credit per page, with up to 100 results per page. Learn more about [API pricing and credits](https://docs.apollo.io/docs/api-pricing).\n\nOrganizations are companies you haven't yet saved as accounts on Apollo.

Use the organization search endpoint to find companies in the Apollo database. Several filters are available to help narrow your search.

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.", "tags": [ "Search" ], "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, countries, and postal codes (ZIP codes). Postal codes are supported for the United States, Germany, and the United Kingdom. To filter by a US ZIP code or a UK postcode, pass it on its own, such as `10017`. For a German postal code, add the country, such as `10115, germany`, because a five-digit code on its own can match a US ZIP code instead.

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 won't 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`; `10017`; `10115, germany`", "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, countries, and postal codes (ZIP codes) as locations to exclude. Postal codes are supported for the United States, Germany, and the United Kingdom. For a German postal code, add the country, such as `10115, germany`, because a five-digit code on its own can match a US ZIP code instead.

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 appear in your search results.

Examples: `minnesota`; `ireland`; `seoul`", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "organization_industry_tag_ids[]", "in": "query", "required": false, "description": "The Apollo IDs for the industries of the companies you want to find. For a company to be included in search results, it only needs to match one of the industries you add.

Each industry in the Apollo database has a unique ID. To find industry IDs, call the organization enrichment endpoint for a company in the industry you want. The `industry_tag_id` field contains the ID of the company's primary industry, and the `industry_tag_hash` field maps each of the company's industry names to its ID.

To search by industry name instead of ID, use the `organization_industries[]` parameter.

Example: `5567cd4773696439b10b0000`", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "organization_not_industry_tag_ids[]", "in": "query", "required": false, "description": "Exclude companies that belong to any of these industries, identified by Apollo industry ID. This is the counterpart to `organization_industry_tag_ids[]`.

To find industry IDs, refer to the `organization_industry_tag_ids[]` parameter.

Example: `5567cd4773696439b10b0000`", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "organization_industries[]", "in": "query", "required": false, "description": "The industry names for the companies you want to find. For a company to be included in search results, it only needs to match one of the industries you add.

Values must exactly match an Apollo industry name, including capitalization and punctuation. Apollo industry names are lowercase. Use the values that Apollo returns in the `industries` field of the organization enrichment endpoint. Partial matches aren't supported.

To search by Apollo industry ID instead, use the `organization_industry_tag_ids[]` parameter.

Examples: `information technology & services`; `hospital & health care`", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "organization_naics_codes[]", "in": "query", "required": false, "description": "The North American Industry Classification System (NAICS) codes for the companies you want to find. For a company to be included in search results, it only needs to match one of the codes you add.

Codes match by prefix, so a shorter code matches every code that starts with it. For example, `5415` matches `541511` and `541512`. You can also enter a range of codes separated by a hyphen. For example, `31-33` matches all codes that start with `31`, `32`, or `33`.

Examples: `541511`; `5415`; `31-33`", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "not_organization_naics_codes[]", "in": "query", "required": false, "description": "Exclude companies that match any of these NAICS codes. This is the counterpart to `organization_naics_codes[]`, and uses the same prefix and range matching.

Examples: `92`; `31-33`", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "organization_sic_codes[]", "in": "query", "required": false, "description": "The Standard Industrial Classification (SIC) codes for the companies you want to find. For a company to be included in search results, it only needs to match one of the codes you add.

Codes match by prefix, so a shorter code matches every code that starts with it. For example, `73` matches `7371` and `7372`. Ranges aren't supported for SIC codes.

Examples: `7372`; `73`", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "not_organization_sic_codes[]", "in": "query", "required": false, "description": "Exclude companies that match any of these SIC codes. This is the counterpart to `organization_sic_codes[]`, and uses the same prefix matching.

Examples: `91`; `7372`", "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_not_organization_keyword_tags[]", "in": "query", "required": false, "description": "Exclude companies associated with any of these keywords. This is the counterpart to `q_organization_keyword_tags[]`.

Each value is matched as an exact phrase against a company's keywords, name, and short description. Matching isn't case-sensitive. A company that matches any of the values you add is excluded. For example, `staffing` excludes companies that have `staffing` as a keyword or in their name or description.

You can add up to 150 keywords.

Examples: `staffing`; `recruiting`", "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": "organization_headcount_growth_past_n_months", "in": "query", "required": false, "description": "The trailing window, in months, used to measure company headcount growth.

Only `6`, `12`, and `24` are accepted. Any other value is ignored.

This parameter has no effect on its own. To filter by headcount growth, send it together with `organization_headcount_growth_range[min]`, `organization_headcount_growth_range[max]`, or both. If you send a window without a range, or a range without a window, the headcount growth filter is skipped and your results come back unfiltered.

Example: `6`", "schema": { "type": "integer", "enum": [ 6, 12, 24 ] } }, { "name": "organization_headcount_growth_range[min]", "in": "query", "required": false, "description": "The minimum company headcount growth, as a percentage, over the window set by `organization_headcount_growth_past_n_months`.

Enter the percentage as a whole number, without a percent sign or decimal point: use `10` for 10% growth. This is a lower bound, so sending a minimum on its own returns every match at or above that figure. Negative values are accepted, but `-20` alone still includes flat and growing companies, because everything above -20% also matches. To isolate companies that shrank, pair a negative minimum with a negative maximum, such as a minimum of `-20` and a maximum of `-1`.

Use `organization_headcount_growth_range[max]` to set the upper bound of the range. You must also send `organization_headcount_growth_past_n_months`.

Examples: `10`; `50`", "schema": { "type": "integer" } }, { "name": "organization_headcount_growth_range[max]", "in": "query", "required": false, "description": "The maximum company headcount growth, as a percentage, over the window set by `organization_headcount_growth_past_n_months`.

Enter the percentage as a whole number, without a percent sign or decimal point: use `100` for 100% growth.

Use `organization_headcount_growth_range[min]` to set the lower bound of the range. You must also send `organization_headcount_growth_past_n_months`.

Examples: `100`; `250`", "schema": { "type": "integer" } }, { "name": "lookalike_organization_ids[]", "in": "query", "required": false, "description": "The Apollo IDs of the companies you want to use as lookalike seeds. Results are narrowed and ranked by similarity to the companies you pass, and the seed companies themselves are excluded from results.

To find IDs, use the `id` value of each entry in the `organizations` array this endpoint returns.

Note the singular `organization` in the parameter name.

You can pass a maximum of five seed companies. Sending more returns a validation error.

If Apollo holds no lookalike data for a seed company, this filter returns no results rather than falling back to an unfiltered search, so an empty response can mean the seed is unusable rather than that no companies match. If that happens, try a different or better-known seed company.

Example: `5e66b6381e05b4008c8331b8`", "schema": { "type": "array", "maxItems": 5, "items": { "type": "string" } } }, { "name": "not_organization_websites_list[]", "in": "query", "required": false, "description": "Exclude companies that match any of these domains. This is the counterpart to `q_organization_domains_list[]`.

Matching covers every domain Apollo holds for a company, not just the one you send, so excluding a single domain also excludes that company's other known domains.

Values are reduced to a domain before matching, so a bare domain, a full URL, or an email address at that domain all work.

Use this parameter to keep companies you already work with, or have already contacted, out of your results without retrieving and enriching them first.

Examples: `apollo.io`; `salesforce.com`", "schema": { "type": "array", "items": { "type": "string" } } }, { "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 576-95-0781", "source": "Scraped", "sanitized_number": "+81576950781" }, "languages": [ "Japanese", "Chinese" ], "alexa_ranking": 1583, "phone": "+81 576-95-0781", "linkedin_uid": "3335963", "founded_year": 1876, "publicly_traded_symbol": null, "publicly_traded_exchange": null, "logo_url": "https://zenprospect-production.s3.amazonaws.com/uploads/pictures/ff63c201695aca418dd88bd9/picture", "crunchbase_url": null, "primary_domain": "nikkei.com", "sanitized_phone": "+81576950781", "owned_by_organization_id": 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 4658-8-1655", "source": "Owler", "sanitized_number": "+81465881655" }, "languages": [], "alexa_ranking": 265731, "phone": "+81 4658-8-1655", "linkedin_uid": "6675", "founded_year": 1947, "publicly_traded_symbol": "8031", "publicly_traded_exchange": "tyo", "logo_url": "https://zenprospect-production.s3.amazonaws.com/uploads/pictures/4c0885d217ca85624ac6b821/picture", "crunchbase_url": null, "primary_domain": "mitsui.com", "sanitized_phone": "+81465881655", "owned_by_organization_id": 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 576-95-0781" }, "source": { "type": "string", "example": "Scraped" }, "sanitized_number": { "type": "string", "example": "+81576950781" } } }, "languages": { "type": "array", "items": { "type": "string", "example": "Japanese" } }, "alexa_ranking": { "type": "integer", "example": 1583, "default": 0 }, "phone": { "type": "string", "example": "+81 576-95-0781" }, "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/ff63c201695aca418dd88bd9/picture" }, "crunchbase_url": {}, "primary_domain": { "type": "string", "example": "nikkei.com" }, "naics_codes": { "type": "array", "description": "The North American Industry Classification System (NAICS) codes for the company. This field is only included when Apollo has NAICS codes for the company.", "items": { "type": "string", "example": "541511" } }, "sic_codes": { "type": "array", "description": "The Standard Industrial Classification (SIC) codes for the company. This field is only included when Apollo has SIC codes for the company.", "items": { "type": "string", "example": "7372" } }, "sanitized_phone": { "type": "string", "example": "+81576950781" }, "owned_by_organization_id": {}, "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 API key. See https://docs.apollo.io/reference/authentication for how to authenticate." } } } } }, "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": { "error_details": { "$ref": "#/components/schemas/ErrorDetails" }, "message": { "deprecated": true, "description": "Legacy error field. Removed on 2027-02-16, after which `error_details` is the only error payload.", "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 \"error_details\": {\n \"code\": \"USAGE.RATE_LIMIT.API_RATE_LIMIT_EXCEEDED\",\n \"message\": \"You have made more API requests than your plan allows in this time window.\",\n \"suggestions\": [\n {\n \"label\": \"Wait until the rate limit resets, then retry the API request.\"\n },\n {\n \"label\": \"Check the Apollo Docs to understand API rate limits and how to use response headers to prevent rate-limit errors.\",\n \"url\": \"https://docs.apollo.io/reference/rate-limits\"\n }\n ],\n \"context\": {\n \"window\": {\n \"value\": \"hour\",\n \"description\": \"The rate limit window that was exhausted, such as \\\"minute\\\" or \\\"hour\\\"\"\n }\n }\n }\n}" } }, "schema": { "type": "object", "properties": { "error_details": { "$ref": "#/components/schemas/ErrorDetails" }, "message": { "deprecated": true, "description": "Legacy error field. Removed on 2027-02-16, after which `error_details` is the only error payload.", "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 } ```