Skip to main content
This guide will get you up and running with Topograph. You’ll learn how to authenticate, find a specific company, and retrieve its data and documents.

​
1. Get your API Key

You’ll need an API key to authenticate your requests.
  1. Sign up or log in to the Topograph Dashboard.
  2. Navigate to Settings > API Keys.
  3. Create a new key (e.g., “Development Key”).
  4. Copy the key. ⚠️ You won’t be able to see it again.

​
2. Search for a Company

The entry point to Topograph is usually a search. Let’s find Airbnb in France. 
curl --request GET \
  --url 'https://api.topograph.co/v2/search?country=FR&query=Airbnb' \
  --header 'x-api-key: <your-api-key>'
This returns a list of matching companies. Locate the one you want and copy its id (e.g., 753121387 for “AIRBNB IRELAND UC”).

​
3. Retrieve Company Data

Now use that id to fetch the full company profile directly from the French register. 
curl --request POST \
  --url https://api.topograph.co/v2/company \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <your-api-key>' \
  --data '{
    "countryCode": "FR",
    "id": "753121387",
    "dataPoints": ["companyProfile"]
  }'
The API response contains verified data: legal name, address, company status, and more.

​
4. Explore more Features

Now that you have the basics, explore what else you can do:

Guide to KYB onboarding

Build a KYB flow wiht high conversion rates

Verification Data

Retrieve high-quality, detailed data, including UBOs and company documents

Understand the Sources

Learn why retrieving data from public registers is difficult

API Reference

Explore all endpoints and parameters