POST
/
companies
/
search
AI company search
curl --request POST \
  --url https://api.village.do/v1/companies/search \
  --header 'Content-Type: application/json' \
  --header 'secret-key: <api-key>' \
  --header 'user-identifier: <user-identifier>' \
  --data '{
  "query": "Fintech companies in London",
  "page": 123,
  "limit": 25
}'
{
  "success": true,
  "data": [
    {
      "id": "acme-corp",
      "type": "company",
      "name": "Acme Corporation",
      "linkedinId": 12345678,
      "linkedinUrl": "https://www.linkedin.com/company/acme-corp",
      "website": "https://www.acme-corp.com",
      "domain": "acme-corp.com",
      "employeeSize": 150,
      "sizeRange": "101-250",
      "founded": 2015,
      "description": "A leading technology company specializing in innovative software solutions for enterprise clients."
    },
    {
      "id": "global-solutions",
      "type": "company",
      "name": "Global Solutions Inc",
      "linkedinId": 87654321,
      "linkedinUrl": "https://www.linkedin.com/company/global-solutions",
      "website": "https://www.globalsolutions.com",
      "domain": "globalsolutions.com",
      "employeeSize": 75,
      "sizeRange": "51-100",
      "founded": 2018
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 2,
    "hasNextPage": true
  },
  "meta": {
    "query": "Fintech companies in London",
    "searchType": "ai",
    "apiVersion": "v1"
  }
}

Authorizations

secret-key
string
header
required

Headers

user-identifier
string
required

Specify the user making the request. This identifier should match the one you used when integrating the user with Village.

Body

application/json

Response

200
application/json

Successfully processed AI search query

The response is of type object.