Search Companies

import requests
BASE_URL = "https://api.filesearch.dev"
API_KEY = "your_api_key"
headers = {"Authorization": f"Bearer {API_KEY}"}
response = requests.get(
    f"{BASE_URL}/v2/datasets/odyssey/companies/search",
    headers=headers,
    params={"q": "credit"},
    timeout=60.0
)
print(response.json())

{
  "query": "credit",
  "limit": 5,
  "results": [
    {
      "name": "Credit",
      "description": "20 años en el sector nos avalan. ¡Estudiamos tu caso!",
      "employee_count": 4,
      "entity_id": null,
      "founded": 2010,
      "industry": "Financial Services",
      "latest_funding_stage": null,
      "linkedin_url": "https://www.linkedin.com/company/credit-house",
      "location": "Passatge de Casanovas, 10; Barcelona, Catalonia 08025, ES",
      "size": "1-10 employees",
      "tags": [
        "finance",
        "clients"
      ],
      "total_funding_raised": null,
      "website": "credit.com"
    }
  ],
  "search_mode": "direct",
  "total_count": 1
}

Search for companies by name or natural language description.

Supports two modes:

Direct lookup: Short queries (1-3 words) like “Stripe” or “OpenAI” resolve directly
Natural language search: Longer queries like “AI startups in San Francisco raising Series B” are translated to structured search queries and return multiple matching companies

Headers:

Authorization: Bearer {api_key}
X-Organization-ID: Organization UUID

Query parameters

qstringRequired

Company name, domain, or natural language search query (e.g. ‘AI startups in San Francisco’)

limitintegerOptional1-25Defaults to 5

Maximum number of results (default 5)

Response

Successful Response

querystring

limitintegerOptionalDefaults to 10

resultslist of objectsOptional

search_modestring or nullOptional

total_countintegerOptionalDefaults to 0

Errors

400

Bad Request Error

500

Internal Server Error