Search companies by industry, size, location or tech

The Companies API

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

Capability: Company discovery
Current price: $0.0532/call
Availability: Ready to run

What this API does

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 quote reflects the selected limits and the wallet settles the verified actual cost plus 40%. Free supplier calls remain free. 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.

Agents select this operation with tool ID the-companies-api.companies-search, then check its current inputs and price before a run.

Inputs and outputs

Input

domainsToExcludestring · optional

comma-separated domains to drop from the results

minLength: 1 · maxLength: 500

linkedinToExcludestring · optional

comma-separated LinkedIn URLs to drop

minLength: 1 · maxLength: 500

pageinteger · optional

1-based page number, default 1

minimum: 1 · maximum: 1000

querystring · required

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

minLength: 1 · maxLength: 500

searchstring · optional

extra free-text match on company name or domain

minLength: 1 · maxLength: 500

searchFieldsarray · optional

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

minItems: 1 · maxItems: 20

sizeinteger · optional

Value supplied for size.

minimum: 1 · maximum: 20

sortKeystring · optional

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

minLength: 1 · maxLength: 500

sortOrderstring · optional

asc | desc

minLength: 1 · maxLength: 500

Output

dataobject

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.

Use Search companies by industry, size, location or tech with Scrollport

Get started

Use verified tools with pay-per-use pricing. Provider access is included. Tools that work in your own apps ask you to connect that account.

Connect your first agent to receive $1 trial credit.