> ## 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.

# Prospeo Search Company: Inputs, Cost & CLI Example

> Build account lists by firmographic criteria (industry, headcount, location, technology, keywords). Includes inputs, outputs, costs, and Deepline CLI examples.

## Run in Enrichment Spreadsheet

<Info>
  Use this function as a column step in `deepline enrich`.
</Info>

```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=prospeo_search_company:{}' --json
```

<Tip>
  Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
</Tip>

## Input Schema

| Name                                      | Type                                               | Required | Default | Description                                 |
| ----------------------------------------- | -------------------------------------------------- | -------- | ------- | ------------------------------------------- |
| `payload.company`                         | `object`                                           | No       |         | Filter by company names or websites.        |
| `payload.company_industry`                | `object`                                           | No       |         | Filter by company industry.                 |
| `payload.company_location_search`         | `object`                                           | No       |         | Filter by company HQ location.              |
| `payload.company_headcount_range`         | `array`                                            | No       |         | Filter by predefined employee count ranges. |
| `payload.company_headcount_custom`        | `object`                                           | No       |         | Filter by custom headcount range.           |
| `payload.company_keywords`                | `object`                                           | No       |         | Filter by keywords in company data.         |
| `payload.company_attributes`              | `object`                                           | No       |         | Filter by company attributes.               |
| `payload.company_naics`                   | `object`                                           | No       |         | Filter by NAICS codes.                      |
| `payload.company_sics`                    | `object`                                           | No       |         | Filter by SIC codes.                        |
| `payload.company_revenue`                 | `object`                                           | No       |         | Filter by revenue range.                    |
| `payload.company_type`                    | `"Private" \| "Public" \| "Non Profit" \| "Other"` | No       |         | Filter by company type value.               |
| `payload.company_funding`                 | `object`                                           | No       |         | Filter by company funding stage/raises.     |
| `payload.company_technology`              | `object`                                           | No       |         | Filter by technologies used by company.     |
| `payload.company_founded`                 | `object`                                           | No       |         | Filter by founding year range.              |
| `payload.company_headcount_growth`        | `object`                                           | No       |         | Filter by headcount growth values.          |
| `payload.company_job_posting_hiring_for`  | `array`                                            | No       |         | Filter by hiring titles in job postings.    |
| `payload.company_job_posting_quantity`    | `object`                                           | No       |         | Filter by number of job postings.           |
| `payload.company_headcount_by_department` | `array`                                            | No       |         | Filter by department headcount.             |
| `payload.company_email_provider`          | `array`                                            | No       |         | Filter by MX provider.                      |
| `payload.page`                            | `integer`                                          | No       | `1`     | Page number (min 1).                        |

### Allowed values

| Field                  | Allowed values                             |
| ---------------------- | ------------------------------------------ |
| `payload.company_type` | `Private`, `Public`, `Non Profit`, `Other` |

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

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Search companies with firmographic filters. The executor maps each filter to: { filters: { <field>: { include: ... } } }. 1 credit per page.",
    "properties": {
      "company": {
        "type": "object",
        "description": "Filter by company names or websites.",
        "properties": {
          "names": {
            "type": "object",
            "description": "Prospeo include/exclude filter object.",
            "properties": {
              "include": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "exclude": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "additionalProperties": false
          },
          "websites": {
            "type": "object",
            "description": "Prospeo include/exclude filter object.",
            "properties": {
              "include": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "exclude": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "company_industry": {
        "type": "object",
        "description": "Filter by company industry.",
        "properties": {
          "include": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "exclude": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "company_location_search": {
        "type": "object",
        "description": "Filter by company HQ location.",
        "properties": {
          "include": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "exclude": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "company_headcount_range": {
        "type": "array",
        "description": "Filter by predefined employee count ranges.",
        "items": {
          "type": "string",
          "enum": [
            "1-10",
            "11-20",
            "21-50",
            "51-100",
            "101-200",
            "201-500",
            "501-1000",
            "1001-2000",
            "2001-5000",
            "5001-10000",
            "10000+"
          ]
        }
      },
      "company_headcount_custom": {
        "type": "object",
        "description": "Filter by custom headcount range.",
        "properties": {
          "min": {
            "type": "integer"
          },
          "max": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "company_keywords": {
        "type": "object",
        "description": "Filter by keywords in company data.",
        "properties": {
          "include": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "exclude": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "include_all": {
            "type": "boolean"
          },
          "include_company_description": {
            "type": "boolean"
          },
          "include_company_description_seo": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "company_attributes": {
        "type": "object",
        "description": "Filter by company attributes.",
        "properties": {
          "b2b": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "demo": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "freetrial": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "downloadable": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "mobileapps": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "onlinereviews": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "pricing": {
            "type": [
              "boolean",
              "null"
            ]
          }
        },
        "additionalProperties": false
      },
      "company_naics": {
        "type": "object",
        "description": "Filter by NAICS codes.",
        "properties": {
          "include": {
            "type": "array",
            "items": {
              "type": "integer"
            }
          },
          "exclude": {
            "type": "array",
            "items": {
              "type": "integer"
            }
          }
        },
        "additionalProperties": false
      },
      "company_sics": {
        "type": "object",
        "description": "Filter by SIC codes.",
        "properties": {
          "include": {
            "type": "array",
            "items": {
              "type": "integer"
            }
          },
          "exclude": {
            "type": "array",
            "items": {
              "type": "integer"
            }
          }
        },
        "additionalProperties": false
      },
      "company_revenue": {
        "type": "object",
        "description": "Filter by revenue range.",
        "properties": {
          "min": {
            "type": "string",
            "enum": [
              "<100K",
              "100K",
              "500K",
              "1M",
              "5M",
              "10M",
              "25M",
              "50M",
              "100M",
              "250M",
              "500M",
              "1B",
              "5B",
              "10B+"
            ]
          },
          "max": {
            "type": "string",
            "enum": [
              "<100K",
              "100K",
              "500K",
              "1M",
              "5M",
              "10M",
              "25M",
              "50M",
              "100M",
              "250M",
              "500M",
              "1B",
              "5B",
              "10B+"
            ]
          },
          "include_unknown_revenue": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "company_type": {
        "type": "string",
        "description": "Filter by company type value.",
        "enum": [
          "Private",
          "Public",
          "Non Profit",
          "Other"
        ]
      },
      "company_funding": {
        "type": "object",
        "description": "Filter by company funding stage/raises.",
        "properties": {
          "stage": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "Angel",
                "Convertible note",
                "Corporate round",
                "Debt financing",
                "Equity crowdfunding",
                "Grant",
                "Initial coin offering",
                "Non equity assistance",
                "Post IPO debt",
                "Post IPO equity",
                "Post IPO secondary",
                "Pre seed",
                "Private equity",
                "Product crowdfunding",
                "Secondary market",
                "Seed",
                "Series A",
                "Series B",
                "Series C",
                "Series D",
                "Series E-J",
                "Series unknown",
                "Undisclosed"
              ]
            }
          },
          "funding_date": {
            "anyOf": [
              {
                "type": "number",
                "const": 30
              },
              {
                "type": "number",
                "const": 60
              },
              {
                "type": "number",
                "const": 90
              },
              {
                "type": "number",
                "const": 180
              },
              {
                "type": "number",
                "const": 270
              },
              {
                "type": "number",
                "const": 365
              }
            ]
          },
          "last_funding": {
            "type": "object",
            "properties": {
              "min": {
                "type": "string",
                "enum": [
                  "<100K",
                  "100K",
                  "500K",
                  "1M",
                  "5M",
                  "10M",
                  "25M",
                  "50M",
                  "100M",
                  "250M",
                  "500M",
                  "1B",
                  "5B",
                  "10B+"
                ]
              },
              "max": {
                "type": "string",
                "enum": [
                  "<100K",
                  "100K",
                  "500K",
                  "1M",
                  "5M",
                  "10M",
                  "25M",
                  "50M",
                  "100M",
                  "250M",
                  "500M",
                  "1B",
                  "5B",
                  "10B+"
                ]
              }
            },
            "additionalProperties": false
          },
          "total_funding": {
            "type": "object",
            "properties": {
              "min": {
                "type": "string",
                "enum": [
                  "<100K",
                  "100K",
                  "500K",
                  "1M",
                  "5M",
                  "10M",
                  "25M",
                  "50M",
                  "100M",
                  "250M",
                  "500M",
                  "1B",
                  "5B",
                  "10B+"
                ]
              },
              "max": {
                "type": "string",
                "enum": [
                  "<100K",
                  "100K",
                  "500K",
                  "1M",
                  "5M",
                  "10M",
                  "25M",
                  "50M",
                  "100M",
                  "250M",
                  "500M",
                  "1B",
                  "5B",
                  "10B+"
                ]
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "company_technology": {
        "type": "object",
        "description": "Filter by technologies used by company.",
        "properties": {
          "include": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "exclude": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "company_founded": {
        "type": "object",
        "description": "Filter by founding year range.",
        "properties": {
          "min": {
            "type": "integer"
          },
          "max": {
            "type": "integer"
          },
          "include_unknown_founded": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "company_headcount_growth": {
        "type": "object",
        "description": "Filter by headcount growth values.",
        "properties": {
          "timeframe_month": {
            "anyOf": [
              {
                "type": "number",
                "const": 3
              },
              {
                "type": "number",
                "const": 6
              },
              {
                "type": "number",
                "const": 12
              },
              {
                "type": "number",
                "const": 24
              }
            ]
          },
          "min": {
            "type": "integer"
          },
          "max": {
            "type": "integer"
          },
          "departments": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "Administrative",
                "Consulting",
                "Customer service",
                "Design / UI / UX",
                "Education",
                "Finance",
                "General management",
                "HR",
                "Legal",
                "Marketing",
                "Medical",
                "Operations",
                "Product",
                "Project management",
                "Real estate",
                "Research",
                "Sales",
                "Technical",
                "Trades"
              ]
            }
          }
        },
        "additionalProperties": false
      },
      "company_job_posting_hiring_for": {
        "type": "array",
        "description": "Filter by hiring titles in job postings.",
        "items": {
          "type": "string"
        }
      },
      "company_job_posting_quantity": {
        "type": "object",
        "description": "Filter by number of job postings.",
        "properties": {
          "min": {
            "type": "integer"
          },
          "max": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "company_headcount_by_department": {
        "type": "array",
        "description": "Filter by department headcount.",
        "items": {
          "type": "object",
          "properties": {
            "department": {
              "type": "string",
              "enum": [
                "C-Suite",
                "Consulting",
                "Design",
                "Education & Coaching",
                "Engineering & Technical",
                "Finance",
                "Human Resources",
                "Information Technology",
                "Legal",
                "Marketing",
                "Medical & Health",
                "Operations",
                "Product",
                "Sales",
                "Chief Executive",
                "Finance Executive",
                "Founder",
                "Human Resources Executive",
                "Information Technology Executive",
                "Legal Executive",
                "Marketing Executive",
                "Medical & Health Executive",
                "Operations Executive",
                "Sales Leader",
                "Product Development",
                "Product Management",
                "All Product",
                "Artificial Intelligence / Machine Learning",
                "Bioengineering",
                "Biometrics",
                "Business Intelligence",
                "Chemical Engineering",
                "Data Science & Analysis",
                "DevOps",
                "Digital Transformation",
                "Emerging Technology / Innovation",
                "Industrial Engineering",
                "Mechanic",
                "Mobile Development",
                "Project Management",
                "Research & Development",
                "Scrum Master / Agile Coach",
                "Software Development",
                "Technician",
                "Technology Operations",
                "Test / Quality Assurance",
                "All Design",
                "Graphic / Visual / Brand Design",
                "Teacher",
                "Superintendent",
                "Professor",
                "Coach / Trainer",
                "Financial Reporting",
                "Financial Systems",
                "Accounting",
                "Finance & Banking",
                "Financial Planning, Strategy & Analysis",
                "Internal Audit & Control",
                "Investor Relations",
                "Mergers & Acquisitions",
                "Real Estate Finance",
                "Financial Risk",
                "Sourcing / Procurement",
                "Tax",
                "Treasury",
                "Compensation & Benefits",
                "Culture, Diversity & Inclusion",
                "Health & Safety",
                "All Human Resources",
                "HR Business Partner",
                "Learning & Development",
                "Organizational Development",
                "Recruiting & Talent Acquisition",
                "Talent Management",
                "Workforce Management",
                "People Operations",
                "Cloud Engineering",
                "Data Center",
                "Data Warehouse",
                "Database Administration",
                "eCommerce Development",
                "Help Desk / Desktop Services",
                "Information Security",
                "IT Asset Management",
                "IT Audit / IT Compliance",
                "IT Recruitement",
                "IT Procurement",
                "IT Strategy",
                "IT Training",
                "Networking",
                "Technical Lead",
                "Quality Assurance",
                "Retail / Store Systems",
                "Servers",
                "Disaster Recovery",
                "Telecommunications",
                "Compliance",
                "Contracts",
                "Corporate Secretary",
                "eDiscovery",
                "Ethics",
                "Governance",
                "Governmental Affairs & Regulatory Law",
                "Intellectual Property & Patent",
                "Labor & Employment",
                "Lawyer / Attorney",
                "All Legal",
                "Legal Counsel",
                "Legal Operations",
                "Litigation",
                "Privacy",
                "Advertising",
                "Brand Management",
                "Content Marketing",
                "Customer Experience",
                "Customer Marketing",
                "Growth & Demand Generation",
                "Digital Marketing",
                "eCommerce Marketing",
                "Event & Field Marketing",
                "Lead Generation",
                "Marketing Operations",
                "Product Marketing",
                "Public Relations",
                "SEO",
                "Social Media Marketing",
                "Technical Marketing",
                "Anesthesiology",
                "Chiropractics",
                "Clinical Systems",
                "Dentistry",
                "Dermatology",
                "Doctors / Physicians",
                "Epidemiology",
                "Fire Responder",
                "Infectious Disease",
                "Medical Administration",
                "Medical Education & Training",
                "Clinical Research",
                "Neurology",
                "Nursing",
                "Nutrition & Dietetics",
                "Obstetrics / Gynecology",
                "Oncology",
                "Opthalmology",
                "Optometry",
                "Orthopedics",
                "Radiology",
                "Public Health",
                "Psychology",
                "Psychiatry",
                "Physical Therapy",
                "Pharmacy",
                "Pediatrics",
                "Pathology",
                "Consultant",
                "All Sales",
                "Sales Training",
                "Sales Operations",
                "Sales Engineering",
                "Sales Enablement",
                "Revenue Operations",
                "Partnerships",
                "Sales Development",
                "Account Executive",
                "Field / Outside Sales",
                "Customer Success",
                "Customer Retention & Development",
                "Channel Sales",
                "Account Management",
                "Supply Chain",
                "Store Operations",
                "Safety",
                "Real Estate",
                "Quality Management",
                "Physical Security",
                "Office Operations",
                "Logistics",
                "Leasing",
                "Facilities Management",
                "Customer Service / Support",
                "Corporate Strategy",
                "Construction",
                "Call Center"
              ]
            },
            "min": {
              "type": "integer"
            },
            "max": {
              "type": "integer"
            }
          },
          "required": [
            "department"
          ],
          "additionalProperties": false
        }
      },
      "company_email_provider": {
        "type": "array",
        "description": "Filter by MX provider.",
        "items": {
          "type": "string"
        }
      },
      "page": {
        "type": "integer",
        "description": "Page number (min 1).",
        "default": 1
      }
    },
    "additionalProperties": false
  }
  ```
</details>

## Output Schema

| Name          | Type     | Required | Default | Description                                    |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `record` | Yes      |         | Provider response payload.                     |
| `result.meta` | `record` | No       |         | Additional response metadata (status, paging). |

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

  ### Output JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "additionalProperties": {}
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": {}
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Advanced: Direct CLI

<Info>
  Use direct execution for single payload debugging.
</Info>

```bash theme={null}
deepline tools execute prospeo_search_company --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: `per_result` (per result).
* Estimated Deepline credits: `0.55` per pricing unit.
* Billing mode: `post_deduct`.