> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Apollo: Company Search

> Search companies by domain, name, industry keywords, employee count (headcount), revenue, funding, technology, and location in Apollo's company dataset.

Search companies by domain, name, industry keywords, employee count (headcount), revenue, funding, technology, and location in Apollo's company dataset.

> [!NOTE]
>
> Tool ID: `apollo_company_search`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'apollo_company_search',
  {
    "page": 123,
    "per_page": 123,
    "q_organization_domains_list": [
      "example.com"
    ]
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute apollo_company_search --input '{
  "page": 123,
  "per_page": 123,
  "q_organization_domains_list": [
    "example.com"
  ]
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "breadcrumbs": [
      {
        "label": "example",
        "signal_field_name": "Example",
        "value": "example"
      }
    ],
    "partial_results_only": true,
    "has_join": true
  }
}
```

Use `deepline describe apollo_company_search --json` for the latest machine-readable contract.

## Input reference

Search Apollo's global company dataset using Organization Search (`organizations/search`). Use this for prospecting companies that may not exist in your Apollo CRM yet, for resolving company identity before people search, and for non-CRM company lookups. Pilot with a tiny query first and inspect `data.organizations` before scaling broad paginated searches.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.page` | `integer` | No | — | Page number (1-500). |
| `payload.per_page` | `integer` | No | — | Results per page (1-100). |
| `payload.q_organization_domains_list` | `array` | No | — | Organization domains to include. |
| `payload.q_organization_name` | `string` | No | — | Organization name search. Prefer this or exact domains for pilot queries before broad pagination. |
| `payload.organization_ids` | `array` | No | — | Apollo organization IDs to include. |
| `payload.organization_num_employees_ranges` | `array` | No | — | Employee ranges accepted by the Apollo organization-search contract, for example '51,200' or '201,500'. Validate with a small pilot query before large paginated pulls. |
| `payload.organization_locations` | `array` | No | — | Organization HQ locations to include. |
| `payload.organization_not_locations` | `array` | No | — | Organization HQ locations to exclude. |
| `payload.q_organization_keyword_tags` | `array` | No | — | Search-style keyword tags. Useful for broad prospecting discovery. pilot first and inspect `data.organizations` before scaling. |
| `payload.organization_industry_tag_ids` | `array` | No | — | Apollo native industry taxonomy tag IDs. Use this when you need exact industry filtering. unlike `q_organization_keyword_tags`, this filters Apollo primary/industry taxonomy rather than description keywords. Apollo does not publish this taxonomy in the public OpenAPI spec. discover IDs from organization rows (`industry_tag_id` / `industry_tag_hash`) or Apollo UI/network payloads. |
| `payload.revenue_range` | `object` | No | — | Inclusive numeric range. |
| `payload.currently_using_any_of_technology_uids` | `array` | No | — | Organizations using ANY of these technology UIDs. |
| `payload.latest_funding_amount_range` | `object` | No | — | Inclusive numeric range. |
| `payload.total_funding_range` | `object` | No | — | Inclusive numeric range. |
| `payload.latest_funding_date_range` | `object` | No | — | Inclusive date range. |
| `payload.q_organization_job_titles` | `array` | No | — | Organizations hiring for these job titles. |
| `payload.organization_job_locations` | `array` | No | — | Organizations hiring in these locations. |
| `payload.organization_num_jobs_range` | `object` | No | — | Inclusive integer range. |
| `payload.organization_job_posted_at_range` | `object` | No | — | Inclusive date range. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Search Apollo's global company dataset using Organization Search (`organizations/search`). Use this for prospecting companies that may not exist in your Apollo CRM yet, for resolving company identity before people search, and for non-CRM company lookups. Pilot with a tiny query first and inspect `data.organizations` before scaling broad paginated searches.",
    "properties": {
      "page": {
        "type": "integer",
        "description": "Page number (1-500)."
      },
      "per_page": {
        "type": "integer",
        "description": "Results per page (1-100)."
      },
      "q_organization_domains_list": {
        "type": "array",
        "description": "Organization domains to include.",
        "items": {
          "type": "string"
        }
      },
      "q_organization_name": {
        "type": "string",
        "description": "Organization name search. Prefer this or exact domains for pilot queries before broad pagination."
      },
      "organization_ids": {
        "type": "array",
        "description": "Apollo organization IDs to include.",
        "items": {
          "type": "string"
        }
      },
      "organization_num_employees_ranges": {
        "type": "array",
        "description": "Employee ranges accepted by the Apollo organization-search contract, for example '51,200' or '201,500'. Validate with a small pilot query before large paginated pulls.",
        "items": {
          "type": "string"
        }
      },
      "organization_locations": {
        "type": "array",
        "description": "Organization HQ locations to include.",
        "items": {
          "type": "string"
        }
      },
      "organization_not_locations": {
        "type": "array",
        "description": "Organization HQ locations to exclude.",
        "items": {
          "type": "string"
        }
      },
      "q_organization_keyword_tags": {
        "type": "array",
        "description": "Search-style keyword tags. Useful for broad prospecting discovery; pilot first and inspect `data.organizations` before scaling.",
        "items": {
          "type": "string"
        }
      },
      "organization_industry_tag_ids": {
        "type": "array",
        "description": "Apollo native industry taxonomy tag IDs. Use this when you need exact industry filtering; unlike `q_organization_keyword_tags`, this filters Apollo primary/industry taxonomy rather than description keywords. Apollo does not publish this taxonomy in the public OpenAPI spec; discover IDs from organization rows (`industry_tag_id` / `industry_tag_hash`) or Apollo UI/network payloads.",
        "items": {
          "type": "string"
        }
      },
      "revenue_range": {
        "type": "object",
        "description": "Inclusive numeric range.",
        "properties": {
          "min": {
            "type": "number",
            "description": "Minimum numeric value."
          },
          "max": {
            "type": "number",
            "description": "Maximum numeric value."
          }
        },
        "additionalProperties": false
      },
      "currently_using_any_of_technology_uids": {
        "type": "array",
        "description": "Organizations using ANY of these technology UIDs.",
        "items": {
          "type": "string"
        }
      },
      "latest_funding_amount_range": {
        "type": "object",
        "description": "Inclusive numeric range.",
        "properties": {
          "min": {
            "type": "number",
            "description": "Minimum numeric value."
          },
          "max": {
            "type": "number",
            "description": "Maximum numeric value."
          }
        },
        "additionalProperties": false
      },
      "total_funding_range": {
        "type": "object",
        "description": "Inclusive numeric range.",
        "properties": {
          "min": {
            "type": "number",
            "description": "Minimum numeric value."
          },
          "max": {
            "type": "number",
            "description": "Maximum numeric value."
          }
        },
        "additionalProperties": false
      },
      "latest_funding_date_range": {
        "type": "object",
        "description": "Inclusive date range.",
        "properties": {
          "min": {
            "type": "string",
            "description": "Minimum date/time (ISO 8601)."
          },
          "max": {
            "type": "string",
            "description": "Maximum date/time (ISO 8601)."
          }
        },
        "additionalProperties": false
      },
      "q_organization_job_titles": {
        "type": "array",
        "description": "Organizations hiring for these job titles.",
        "items": {
          "type": "string"
        }
      },
      "organization_job_locations": {
        "type": "array",
        "description": "Organizations hiring in these locations.",
        "items": {
          "type": "string"
        }
      },
      "organization_num_jobs_range": {
        "type": "object",
        "description": "Inclusive integer range.",
        "properties": {
          "min": {
            "type": "integer",
            "description": "Minimum integer value."
          },
          "max": {
            "type": "integer",
            "description": "Maximum integer value."
          }
        },
        "additionalProperties": false
      },
      "organization_job_posted_at_range": {
        "type": "object",
        "description": "Inclusive date range.",
        "properties": {
          "min": {
            "type": "string",
            "description": "Minimum date/time (ISO 8601)."
          },
          "max": {
            "type": "string",
            "description": "Maximum date/time (ISO 8601)."
          }
        },
        "additionalProperties": false
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Apollo company search result. Deepline wraps Apollo payload under `data`, so read companies at `result.data.organizations` in tools output (or `&lt;column&gt;.data.organizations` in enrich columns). Organization rows include Apollo company fields such as `industry`, `sic_codes`, and `naics_codes` when Apollo returns them.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Apollo native payload with top-level `&#123; organizations, pagination &#125;` fields. |
| `result.data.breadcrumbs` | `array` | No | — | — |
| `result.data.breadcrumbs[].label` | `string` | No | — | — |
| `result.data.breadcrumbs[].signal_field_name` | `string` | No | — | — |
| `result.data.breadcrumbs[].value` | `string \| number \| boolean \| array \| null` | No | — | — |
| `result.data.breadcrumbs[].display_name` | `string` | No | — | — |
| `result.data.partial_results_only` | `boolean` | No | — | — |
| `result.data.has_join` | `boolean` | No | — | — |
| `result.data.disable_eu_prospecting` | `boolean` | No | — | — |
| `result.data.partial_results_limit` | `number` | No | — | — |
| `result.data.organizations` | `array` | No | — | — |
| `result.data.organizations[].id` | `string` | No | — | — |
| `result.data.organizations[].name` | `string` | No | — | — |
| `result.data.organizations[].website_url` | `string \| null` | No | — | — |
| `result.data.organizations[].blog_url` | `string \| null` | No | — | — |
| `result.data.organizations[].angellist_url` | `string \| null` | No | — | — |
| `result.data.organizations[].linkedin_url` | `string \| null` | No | — | — |
| `result.data.organizations[].twitter_url` | `string \| null` | No | — | — |
| `result.data.organizations[].facebook_url` | `string \| null` | No | — | — |
| `result.data.organizations[].primary_phone` | `object` | No | — | — |
| `result.data.organizations[].primary_phone.number` | `string \| null` | No | — | — |
| `result.data.organizations[].primary_phone.source` | `string \| null` | No | — | — |
| `result.data.organizations[].primary_phone.sanitized_number` | `string \| null` | No | — | — |
| `result.data.organizations[].languages` | `array` | No | — | — |
| `result.data.organizations[].alexa_ranking` | `number \| null` | No | — | — |
| `result.data.organizations[].phone` | `string \| null` | No | — | — |
| `result.data.organizations[].linkedin_uid` | `string \| null` | No | — | — |
| `result.data.organizations[].founded_year` | `number \| null` | No | — | — |
| `result.data.organizations[].publicly_traded_symbol` | `string \| null` | No | — | — |
| `result.data.organizations[].publicly_traded_exchange` | `string \| null` | No | — | — |
| `result.data.organizations[].logo_url` | `string \| null` | No | — | — |
| `result.data.organizations[].crunchbase_url` | `string \| null` | No | — | — |
| `result.data.organizations[].primary_domain` | `string \| null` | No | — | — |
| `result.data.organizations[].sanitized_phone` | `string \| null` | No | — | — |
| `result.data.organizations[].owned_by_organization_id` | `string \| null` | No | — | — |
| `result.data.organizations[].estimated_num_employees` | `number \| null` | No | — | — |
| `result.data.organizations[].industry` | `string \| null` | No | — | — |
| `result.data.organizations[].industries` | `array` | No | — | — |
| `result.data.organizations[].secondary_industries` | `array` | No | — | — |
| `result.data.organizations[].industry_tag_id` | `string \| null` | No | — | — |
| `result.data.organizations[].industry_tag_hash` | `record` | No | — | — |
| `result.data.organizations[].sic_codes` | `array` | No | — | — |
| `result.data.organizations[].naics_codes` | `array` | No | — | — |
| `result.data.organizations[].short_description` | `string \| null` | No | — | — |
| `result.data.organizations[].raw_address` | `string \| null` | No | — | — |
| `result.data.organizations[].street_address` | `string \| null` | No | — | — |
| `result.data.organizations[].postal_code` | `string \| null` | No | — | — |
| `result.data.organizations[].city` | `string \| null` | No | — | — |
| `result.data.organizations[].state` | `string \| null` | No | — | — |
| `result.data.organizations[].country` | `string \| null` | No | — | — |

The table shows the first 50 fields. Expand the raw schema below for every field.

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Apollo company search result. Deepline wraps Apollo payload under `data`, so read companies at `result.data.organizations` in tools output (or `<column>.data.organizations` in enrich columns). Organization rows include Apollo company fields such as `industry`, `sic_codes`, and `naics_codes` when Apollo returns them.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Apollo native payload with top-level `{ organizations, pagination }` fields.",
        "properties": {
          "breadcrumbs": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "label": {
                  "type": "string"
                },
                "signal_field_name": {
                  "type": "string"
                },
                "value": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "number"
                    },
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "display_name": {
                  "type": "string"
                }
              },
              "additionalProperties": false
            }
          },
          "partial_results_only": {
            "type": "boolean"
          },
          "has_join": {
            "type": "boolean"
          },
          "disable_eu_prospecting": {
            "type": "boolean"
          },
          "partial_results_limit": {
            "type": "number"
          },
          "organizations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "website_url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "blog_url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "angellist_url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "linkedin_url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "twitter_url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "facebook_url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "primary_phone": {
                  "type": "object",
                  "properties": {
                    "number": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "source": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "sanitized_number": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "additionalProperties": false
                },
                "languages": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "alexa_ranking": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "phone": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "linkedin_uid": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "founded_year": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "publicly_traded_symbol": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "publicly_traded_exchange": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "logo_url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "crunchbase_url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "primary_domain": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "sanitized_phone": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "owned_by_organization_id": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "estimated_num_employees": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "industry": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "industries": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "secondary_industries": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "industry_tag_id": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "industry_tag_hash": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "string"
                  }
                },
                "sic_codes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "naics_codes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "short_description": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "raw_address": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "street_address": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "postal_code": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "city": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "state": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "country": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "organization_revenue": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "organization_revenue_printed": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "total_funding": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "latest_funding_round_date": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "latest_funding_stage": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "keywords": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "technology_names": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "current_technologies": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "additionalProperties": {}
                  }
                },
                "annual_revenue": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "annual_revenue_printed": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "subindustry": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "intent_strength": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "show_intent": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "has_intent_signal_account": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "intent_signal_account": {
                  "type": [
                    "object",
                    "null"
                  ],
                  "additionalProperties": {}
                }
              },
              "additionalProperties": false
            }
          },
          "pagination": {
            "type": "object",
            "properties": {
              "page": {
                "type": "number"
              },
              "per_page": {
                "type": "number"
              },
              "total_entries": {
                "type": "number"
              },
              "total_pages": {
                "type": "number"
              }
            },
            "additionalProperties": false
          },
          "model_ids": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "num_fetch_result": {
            "type": [
              "number",
              "null"
            ]
          },
          "derived_params": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": {}
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": {}
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0.17` per pricing unit.

## Related documentation

* [Apollo provider guide](https://deepline.com/docs/providers/apollo/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.