Companies

List Companies

Get your top-connected companies ranked by network strength. Use this to discover which companies you have the best access to through your professional network. Returns a paginated list with: connection score, score_label, LinkedIn URL, and domain for each company. Supports cursor-based pagination and optional connection degree filtering.

post/v2/companies

Request

  • Base URL: https://api.village.ai
  • URL: https://api.village.ai/v2/companies
  • Auth: HTTP bearer

Request body

cursorstring

Opaque cursor for pagination (from previous response)

limitinteger

Number of results per page (default 25, max 100)

connection_degreesinteger[]

Filter by connection degree (1=direct, 2=second-degree, 3=third-degree)

Example request

{
  "limit": 25,
  "connection_degrees": [
    1,
    2
  ]
}

Response

Top companies retrieved successfully

Example response

{
  "pagination": {
    "cursor": "eyJpZCI6IjEyMzQ1In0",
    "has_next_page": true,
    "count": 20
  }
}

Changes