Skip to main content
Topograph offers a powerful search API to find companies across multiple countries. The search endpoint allows to find companies based on two main search criteria.
  1. Company name (legal name, commercial name, or historical name)
  2. Company number (registration number, tax number, or VAT number)
It’s important to note that availability of these search methods can vary depending on the country you’re searching in.

​
Response Times

Search response times vary based on the specific register we need to query:
  • Fastest responses: A few hundred milliseconds
  • Slowest responses: Up to ten seconds
For a detailed breakdown of:
  • Available search methods by country
  • Expected response times for each country
  • Other country-specific search information
Please refer to our comprehensive coverage map as well as the Country Specifics page.

​
Search Endpoint

Request
curl --request GET \
  --url 'https://api.topograph.co/v2/search?country=FR&query=Topograph' \
  --header 'x-api-key: <api-key>'

​
Query Parameters

ParameterRequiredDescription
countryYesCountry code for the search. Can be an ISO country code (e.g., “FR”, “GB”, “DE”). For US states and Canada provinces, combine “US” or “CA” with the state code (e.g., “US-CA” for California).
queryYesThe search term - can be a company name or company number.

​
Response

The search results include basic company information such as:
  • Legal name (and English translation for non-Latin names)
  • Registration number and/or tax number
  • Legal address
  • Country code
Example response: 
[
  {
    "id": "932884117",
    "legalName": "SEMAPHORE",
    "legalNameInEnglish": null,
    "countryCode": "FR",
    "address": {
      "addressLine1": "10 rue de la Fraternité",
      "city": "Bagnolet",
      "postalCode": "93170",
      "state": "Île-de-France",
      "countryCode": "FR"
    }
  }
]

​
Result Ordering

Search results are ordered by relevance and search method priority. If the query contains or matches an exact company registration ID (based on the country’s format), results from direct ID searches will appear at the top. This ensures precise matches are prioritized over broader name-based searches. Other results (from name searches, VAT-derived, or agentic methods) follow in descending order of specificity.
The company number format may vary by country. For example, in Germany it might be a concatenation of the register and city (e.g., “Augsburg HRB 34617”). The search function will always return a usable company number that can be used with other endpoints and features of Topograph.
Once you have found a company through the search endpoint, you can use its ID to retrieve more detailed information using the Company Data endpoint.