Search Company

Search for companies based on various filters. Multiple filters within the same field are combined with AND logic.

POST /company/search

Search company

cURL

curl --request POST \
  --url https://app.fullenrich.com/api/v2/company/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "offset": 20,
  "limit": 20,
  "names": [
    {
      "value": "Microsoft",
      "exact_match": true,
      "exclude": false
    }
  ],
  "domains": [
    {
      "value": "microsoft.com",
      "exact_match": true,
      "exclude": false
    }
  ],
  "linkedin_urls": [
    {
      "value": "https://www.linkedin.com/company/fullenrich",
      "exact_match": true,
      "exclude": false
    }
  ],
  "keywords": [
    {
      "value": "innovative and practical products",
      "exact_match": false,
      "exclude": false
    }
  ],
  "specialties": [
    {
      "value": "AI safety",
      "exact_match": false,
      "exclude": false
    }
  ],
  "industries": [
    {
      "value": "Software Development",
      "exact_match": false,
      "exclude": false
    },
    {
      "value": "Computer Hardware Manufacturing",
      "exact_match": false,
      "exclude": false
    }
  ],
  "types": [
    {
      "value": "Public Company",
      "exact_match": true,
      "exclude": false
    }
  ],
  "headquarters_locations": [
    {
      "value": "San Francisco",
      "exact_match": false,
      "exclude": false
    }
  ],
  "founded_years": [
    {
      "min": 2015,
      "max": 2024,
      "exclude": false
    }
  ],
  "headcounts": [
    {
      "min": 100,
      "max": 500,
      "exclude": false
    }
  ],
  "company_ids": [
    {
      "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "exclude": false,
      "exact_match": true
    }
  ]
}
'

import requests

url = "https://app.fullenrich.com/api/v2/company/search"

payload = {
    "offset": 20,
    "limit": 20,
    "names": [
        {
            "value": "Microsoft",
            "exact_match": True,
            "exclude": False
        }
    ],
    "domains": [
        {
            "value": "microsoft.com",
            "exact_match": True,
            "exclude": False
        }
    ],
    "linkedin_urls": [
        {
            "value": "https://www.linkedin.com/company/fullenrich",
            "exact_match": True,
            "exclude": False
        }
    ],
    "keywords": [
        {
            "value": "innovative and practical products",
            "exact_match": False,
            "exclude": False
        }
    ],
    "specialties": [
        {
            "value": "AI safety",
            "exact_match": False,
            "exclude": False
        }
    ],
    "industries": [
        {
            "value": "Software Development",
            "exact_match": False,
            "exclude": False
        },
        {
            "value": "Computer Hardware Manufacturing",
            "exact_match": False,
            "exclude": False
        }
    ],
    "types": [
        {
            "value": "Public Company",
            "exact_match": True,
            "exclude": False
        }
    ],
    "headquarters_locations": [
        {
            "value": "San Francisco",
            "exact_match": False,
            "exclude": False
        }
    ],
    "founded_years": [
        {
            "min": 2015,
            "max": 2024,
            "exclude": False
        }
    ],
    "headcounts": [
        {
            "min": 100,
            "max": 500,
            "exclude": False
        }
    ],
    "company_ids": [
        {
            "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "exclude": False,
            "exact_match": True
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    offset: 20,
    limit: 20,
    names: [{value: 'Microsoft', exact_match: true, exclude: false}],
    domains: [{value: 'microsoft.com', exact_match: true, exclude: false}],
    linkedin_urls: [
      {
        value: 'https://www.linkedin.com/company/fullenrich',
        exact_match: true,
        exclude: false
      }
    ],
    keywords: [
      {value: 'innovative and practical products', exact_match: false, exclude: false}
    ],
    specialties: [{value: 'AI safety', exact_match: false, exclude: false}],
    industries: [
      {value: 'Software Development', exact_match: false, exclude: false},
      {value: 'Computer Hardware Manufacturing', exact_match: false, exclude: false}
    ],
    types: [{value: 'Public Company', exact_match: true, exclude: false}],
    headquarters_locations: [{value: 'San Francisco', exact_match: false, exclude: false}],
    founded_years: [{min: 2015, max: 2024, exclude: false}],
    headcounts: [{min: 100, max: 500, exclude: false}],
    company_ids: [
      {
        value: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
        exclude: false,
        exact_match: true
      }
    ]
  })
};

fetch('https://app.fullenrich.com/api/v2/company/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.fullenrich.com/api/v2/company/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'offset' => 20,
    'limit' => 20,
    'names' => [
        [
                'value' => 'Microsoft',
                'exact_match' => true,
                'exclude' => false
        ]
    ],
    'domains' => [
        [
                'value' => 'microsoft.com',
                'exact_match' => true,
                'exclude' => false
        ]
    ],
    'linkedin_urls' => [
        [
                'value' => 'https://www.linkedin.com/company/fullenrich',
                'exact_match' => true,
                'exclude' => false
        ]
    ],
    'keywords' => [
        [
                'value' => 'innovative and practical products',
                'exact_match' => false,
                'exclude' => false
        ]
    ],
    'specialties' => [
        [
                'value' => 'AI safety',
                'exact_match' => false,
                'exclude' => false
        ]
    ],
    'industries' => [
        [
                'value' => 'Software Development',
                'exact_match' => false,
                'exclude' => false
        ],
        [
                'value' => 'Computer Hardware Manufacturing',
                'exact_match' => false,
                'exclude' => false
        ]
    ],
    'types' => [
        [
                'value' => 'Public Company',
                'exact_match' => true,
                'exclude' => false
        ]
    ],
    'headquarters_locations' => [
        [
                'value' => 'San Francisco',
                'exact_match' => false,
                'exclude' => false
        ]
    ],
    'founded_years' => [
        [
                'min' => 2015,
                'max' => 2024,
                'exclude' => false
        ]
    ],
    'headcounts' => [
        [
                'min' => 100,
                'max' => 500,
                'exclude' => false
        ]
    ],
    'company_ids' => [
        [
                'value' => 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
                'exclude' => false,
                'exact_match' => true
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.fullenrich.com/api/v2/company/search"

	payload := strings.NewReader("{\n  \"offset\": 20,\n  \"limit\": 20,\n  \"names\": [\n    {\n      \"value\": \"Microsoft\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"domains\": [\n    {\n      \"value\": \"microsoft.com\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"linkedin_urls\": [\n    {\n      \"value\": \"https://www.linkedin.com/company/fullenrich\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"keywords\": [\n    {\n      \"value\": \"innovative and practical products\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"specialties\": [\n    {\n      \"value\": \"AI safety\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"industries\": [\n    {\n      \"value\": \"Software Development\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"Computer Hardware Manufacturing\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"types\": [\n    {\n      \"value\": \"Public Company\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"headquarters_locations\": [\n    {\n      \"value\": \"San Francisco\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"founded_years\": [\n    {\n      \"min\": 2015,\n      \"max\": 2024,\n      \"exclude\": false\n    }\n  ],\n  \"headcounts\": [\n    {\n      \"min\": 100,\n      \"max\": 500,\n      \"exclude\": false\n    }\n  ],\n  \"company_ids\": [\n    {\n      \"value\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n      \"exclude\": false,\n      \"exact_match\": true\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.fullenrich.com/api/v2/company/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"offset\": 20,\n  \"limit\": 20,\n  \"names\": [\n    {\n      \"value\": \"Microsoft\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"domains\": [\n    {\n      \"value\": \"microsoft.com\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"linkedin_urls\": [\n    {\n      \"value\": \"https://www.linkedin.com/company/fullenrich\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"keywords\": [\n    {\n      \"value\": \"innovative and practical products\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"specialties\": [\n    {\n      \"value\": \"AI safety\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"industries\": [\n    {\n      \"value\": \"Software Development\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"Computer Hardware Manufacturing\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"types\": [\n    {\n      \"value\": \"Public Company\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"headquarters_locations\": [\n    {\n      \"value\": \"San Francisco\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"founded_years\": [\n    {\n      \"min\": 2015,\n      \"max\": 2024,\n      \"exclude\": false\n    }\n  ],\n  \"headcounts\": [\n    {\n      \"min\": 100,\n      \"max\": 500,\n      \"exclude\": false\n    }\n  ],\n  \"company_ids\": [\n    {\n      \"value\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n      \"exclude\": false,\n      \"exact_match\": true\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.fullenrich.com/api/v2/company/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"offset\": 20,\n  \"limit\": 20,\n  \"names\": [\n    {\n      \"value\": \"Microsoft\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"domains\": [\n    {\n      \"value\": \"microsoft.com\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"linkedin_urls\": [\n    {\n      \"value\": \"https://www.linkedin.com/company/fullenrich\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"keywords\": [\n    {\n      \"value\": \"innovative and practical products\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"specialties\": [\n    {\n      \"value\": \"AI safety\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"industries\": [\n    {\n      \"value\": \"Software Development\",\n      \"exact_match\": false,\n      \"exclude\": false\n    },\n    {\n      \"value\": \"Computer Hardware Manufacturing\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"types\": [\n    {\n      \"value\": \"Public Company\",\n      \"exact_match\": true,\n      \"exclude\": false\n    }\n  ],\n  \"headquarters_locations\": [\n    {\n      \"value\": \"San Francisco\",\n      \"exact_match\": false,\n      \"exclude\": false\n    }\n  ],\n  \"founded_years\": [\n    {\n      \"min\": 2015,\n      \"max\": 2024,\n      \"exclude\": false\n    }\n  ],\n  \"headcounts\": [\n    {\n      \"min\": 100,\n      \"max\": 500,\n      \"exclude\": false\n    }\n  ],\n  \"company_ids\": [\n    {\n      \"value\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n      \"exclude\": false,\n      \"exact_match\": true\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

200

Example

{
  "companies": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Anthropic",
      "domain": "anthropic.com",
      "description": "AI safety and research company building reliable, interpretable, and steerable AI systems.",
      "year_founded": 2021,
      "headcount": 2610,
      "headcount_range": "1001-5000",
      "company_type": "Privately Held",
      "locations": {
        "headquarters": {
          "line1": "548 Market St",
          "line2": "PMB 42570",
          "city": "San Francisco",
          "region": "California",
          "country": "United States",
          "country_code": "US"
        },
        "offices": [
          {
            "line1": "548 Market St",
            "line2": "PMB 42570",
            "city": "San Francisco",
            "region": "California",
            "country": "United States",
            "country_code": "US"
          }
        ]
      },
      "social_profiles": {
        "linkedin": {
          "url": "https://www.linkedin.com/company/anthropic",
          "handle": "anthropic",
          "follower_count": 125000
        }
      },
      "specialties": [
        "artificial intelligence",
        "machine learning",
        "AI safety"
      ],
      "industry": {
        "main_industry": "Software Development"
      }
    }
  ],
  "metadata": {
    "total": 20523,
    "offset": 0
  }
}

The Company Search endpoint allows you to search for companies by size, industry, location, founding year, specialties, and more. It is designed to help you build clean company lists for prospecting, enrichment, or market analysis.

**If you want to retrieve one specific company, **you can search directly using its LinkedIn company URL or domain for an exact match.

Predefined Filter Values

For a full list of supported filters and accepted values (industries, company types, seniority levels, etc.)

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

offset · integer

Number of companies to skip (use this for pagination)

Example:

20

limit · integer

Number of companies to return (default: 10, max: 100)

Example:

20

names · object[]

Filter by company names. Use exact_match for precise company name matching.

Show child attributes

Example:

[
  {
    "value": "Microsoft",
    "exact_match": true,
    "exclude": false
  }
]

domains · object[]

Filter by company domains (e.g., 'google.com', 'microsoft.com'). Exact match recommended.

Show child attributes

Example:

[
  {
    "value": "microsoft.com",
    "exact_match": true,
    "exclude": false
  }
]

linkedin_urls · object[]

Filter by LinkedIn URLs.

Show child attributes

Example:

[
  {
    "value": "https://www.linkedin.com/company/fullenrich",
    "exact_match": true,
    "exclude": false
  }
]

keywords · object[]

Filter by description of company

Show child attributes

Example:

[
  {
    "value": "innovative and practical products",
    "exact_match": false,
    "exclude": false
  }
]

specialties · object[]

Filter by specialties of company

Show child attributes

Example:

[
  {
    "value": "AI safety",
    "exact_match": false,
    "exclude": false
  }
]

industries · object[]

Filter by company industries (e.g., 'Software Development', 'Computer Hardware Manufacturing', 'Housing and Community Development', 'Warehousing', 'Financial Services')

Show child attributes

Example:

[
  {
    "value": "Software Development",
    "exact_match": false,
    "exclude": false
  },
  {
    "value": "Computer Hardware Manufacturing",
    "exact_match": false,
    "exclude": false
  }
]

types · object[]

Filter by company types (e.g., 'Public Company', 'Privately Held', 'Non-profit', 'Self-employed', 'Partnership')

Show child attributes

Example:

[
  {
    "value": "Public Company",
    "exact_match": true,
    "exclude": false
  }
]

headquarters_locations · object[]

Filter by headquarters locations (city names, regions, or countries)

Show child attributes

Example:

[
  {
    "value": "San Francisco",
    "exact_match": false,
    "exclude": false
  }
]

founded_years · object[]

Filter by founding years. Useful for targeting startups (recent years) or established companies.

Show child attributes

Example:

[
  {
    "min": 2015,
    "max": 2024,
    "exclude": false
  }
]

headcounts · object[]

Filter by company headcounts (number of employees). Use ranges to target specific company sizes (e.g., startups: 1-50, mid-size: 50-500, enterprise: 1000+).

Show child attributes

Example:

[
  { "min": 100, "max": 500, "exclude": false }
]

company_ids · object[]

Filter by specific company IDs

Show child attributes

Response

200

application/json

OK

companies · object[]

Array of companies matching the search criteria. Returns empty array if no results found.

Show child attributes

metadata · object

Show child attributes