> ## 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: Inputs, Cost & CLI Example
> Searching Apollo company records with full company filters. Includes inputs, outputs, pricing notes, Deepline CLI examples, and GTM automation guidance.
## Run in Enrichment Spreadsheet
Use this function as a column step in `deepline enrich`.
```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=apollo_company_search:{}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| ------------------------------------------------ | --------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `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. |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"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
}
```
## Output Schema
| Name | Type | Required | Default | Description |
| ------------- | -------- | -------- | ------- | -------------------------------------------------------------------------------------- |
| `result.data` | `object` | Yes | | Apollo native payload with top-level `{ organizations, pagination }` fields. |
| `result.meta` | `record` | No | | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"type": "object",
"description": "Apollo company search result. Deepline wraps Apollo payload under `data`, so read companies at `result.data.organizations` in tools output (or `.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
}
```
## Advanced: Direct CLI
Use direct execution for single payload debugging.
```bash theme={null}
deepline tools execute apollo_company_search --payload '{}' --json
```
### CLI flags
| Flag | Description |
| --------------------------- | --------------------------------------------------- |
| `--json` | Print machine-readable output. |
| `--wait` | Wait for terminal provider status when supported. |
| `--debug` | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS` | Max seconds to wait in wait mode. |
| `--poll-interval SECONDS` | Polling interval in seconds during wait mode. |
| `--timeout SECONDS` | Request timeout in seconds. |
| `--connect-timeout SECONDS` | Connection timeout in seconds. |
## Cost
* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0.17` per pricing unit.
* Billing mode: `post_deduct`.