# Search companies by industry, size, location or tech

The Companies API

Search companies by industry, size, location, technology or any other attribute filter

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Search companies by industry, size, location or tech (tool ID: the-companies-api.companies-search). Ask me for the details you need, then show me the result.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

Provider access is included.

Connect your first agent to receive $1 trial credit.

**Job:** [Find companies](https://scrollport.com/tools/company-search-api)

**Current price:** $0.0532/request

**Availability:** Ready to run

## Tool details

**About this tool**

Search companies by industry, size, location, technology or any other attribute filter Retrieve one bounded result or page using the documented fields. Pagination is explicit: follow-up pages require another run. The catalog price is the maximum per request; the upfront quote reflects the selected limits. Completed requests cost that quote, including valid empty pages and no-match answers. Supplier waivers do not change the customer price. Failed requests are uncharged. Results contain reviewed business data and available pagination. The worked example shows selected fields from a recorded response, with at most the first item of each list.

**Inputs and outputs**

### Input

`domainsToExclude` string · optional

comma-separated domains to drop from the results

minLength: 1 · maxLength: 500

`linkedinToExclude` string · optional

comma-separated LinkedIn URLs to drop

minLength: 1 · maxLength: 500

`page` integer · optional

1-based page number, default 1

minimum: 1 · maximum: 1000

`query` string · required

a stringified, URL-encoded ARRAY of conditions, each {attribute, operator: 'and'|'or', sign: 'equals'|…, values: \[...\]}

minLength: 1 · maxLength: 500

`search` string · optional

extra free-text match on company name or domain

minLength: 1 · maxLength: 500

`searchFields` array · optional

which fields \`search\` applies to, e.g. domain, name

minItems: 1 · maxItems: 20

`size` integer · optional

Value supplied for size.

minimum: 1 · maximum: 20

`sortKey` string · optional

field to sort by, e.g. meta.score, about.name

minLength: 1 · maxLength: 500

`sortOrder` string · optional

asc | desc

minLength: 1 · maxLength: 500

### Output

`data` object

Returned data value.

**Example request and output**

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

### Request

```
{
  "tool_id": "the-companies-api.companies-search",
  "input": {
    "page": 1,
    "size": 1,
    "query": "[{\"attribute\": \"about.industries\", \"operator\": \"or\", \"sign\": \"equals\", \"values\": [\"fintech\"]}]"
  }
}
```

### Output

```
{
  "data": {
    "companies": [
      {
        "about": {
          "name": "PayPal",
          "industry": "financial-services",
          "nameAlts": [
            "PayPal.com"
          ],
          "languages": [
            "eng_Latn"
          ],
          "industries": [
            "digital-payments"
          ]
        },
        "codes": {
          "sic": [
            "62499"
          ],
          "naics": [
            "53121"
          ]
        },
        "domain": {
          "domain": "paypal.com",
          "status": 200
        },
        "finances": {
          "revenue": "over-1b"
        },
        "companies": {
          "acquisitions": [
            {
              "name": "Curv",
              "domain": "curv.co"
            }
          ],
          "subsidiaries": [
            {
              "name": "Braintree",
              "domain": "braintreepayments.com",
              "description": "We provide the global commerce tools people need to build businesses, accept payments, and enable commerce for their users."
            }
          ]
        },
        "secondaries": {
          "emailPatterns": [
            {
              "pattern": "[F1][L]",
              "usagePercentage": 95.1558
            }
          ]
        },
        "descriptions": {
          "website": "From paying friends to saving money or getting cash back when you shop, explore what the new PayPal app has to offer."
        }
      }
    ]
  }
}
```

**Errors and limitations**

- `invalid_input`: The lookup fields or limits are invalid.example: {"query":"\[{\\"attribute\\": \\"about.industries\\", \\"operator\\": \\"or\\", \\"sign\\": \\"equals\\", \\"values\\": \[\\"fintech\\"\]}\]","size":1,"page":1}
- `upstream_error`: The provider could not complete a verified result; the wallet was not charged.Check the documented fields and contact Scrollport support with the run ID if needed.

---

Canonical page: https://scrollport.com/tools/providers/the-companies-api/companies-search