Skip to main content
GET
/
v2
/
companies
List Companies
curl --request GET \
  --url https://api.village.do/v2/companies \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "data": [
      {
        "score": 123,
        "score_label": "<string>",
        "linkedin_url": "<string>",
        "domain_name": "<string>"
      }
    ],
    "pagination": {
      "page": 123,
      "limit": 123,
      "hasNextPage": true
    }
  },
  "metadata": {
    "request_id": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Use the API token from your personal Village account: https://village.do/settings#api-keys

For verified apps accessing user data, create a user token: https://docs.village.do/api-reference-v2/authentication/create-authorization

Query Parameters

page
string

Page number (1-based)

Example:

"1"

limit
string

Number of companies per page (max 100)

Example:

"50"

Response

Top companies retrieved successfully

data
object
required

List of top companies by connection strength with pagination

metadata
object
required