Skip to main content
POST
/
v2
/
companies
/
search
Search Companies
curl --request POST \
  --url https://api.village.do/v2/companies/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Find B2B SaaS companies with 50-200 employees in California",
  "limit": 25,
  "high_reasoning": false,
  "cursor": "<string>"
}
'
{
  "data": {
    "results": [
      {
        "id": "<string>",
        "name": "<string>",
        "domain": "<string>",
        "linkedin_url": "<string>",
        "website": "<string>",
        "employee_size": 123,
        "industry": "<string>",
        "description": "<string>",
        "location": "<string>",
        "warmth_score": 123,
        "warmth_label": "<string>"
      }
    ],
    "has_next_page": true,
    "count": 123,
    "cursor": "<string>",
    "source": "network"
  },
  "metadata": {
    "request_id": "<string>"
  }
}

Authorizations

Authorization
string
header
required

JWT token obtained from authentication endpoint

Body

application/json

Request body for searching companies with natural language

prompt
string
required

Natural language search query

Minimum string length: 1
Example:

"Find B2B SaaS companies with 50-200 employees in California"

limit
integer
default:25

Maximum number of results per page

Required range: 1 <= x <= 100
Example:

25

high_reasoning
boolean
default:false

Enable high reasoning mode for more accurate results

Example:

false

cursor

Pagination cursor (encoded string or cursor object)

Response

Search completed successfully

data
object
required

Paginated companies search results

metadata
object
required