The help center explains how things work; the API documentation lists every endpoint with all its parameters and sample responses. You'll find it at flowdata.one/en/docs, publicly and without logging in, also in German and Portuguese.
How to get there
- In the dashboard, on the left under More, click API documentation
- On every area page, at the top right, click Documentation to go straight to that area
What's on the pages
The start page gives the base URL https://api.flowdata.one/v1, the six areas, the list prices and all OpenAPI files. You can see the prices that apply to your team in the dashboard under Billing.
| Topic | Page |
|---|---|
| Authentication and error codes | /en/docs/authentication |
| IP Geolocation | /en/docs/geolocation |
| Client Info | /en/docs/client-info |
| Maps | /en/docs/maps |
| Email Verifier | /en/docs/email-verification |
| YouTube | /en/docs/youtube |
| Media processing | /en/docs/media |
An area's page lists each endpoint with its path, query and body parameters, an example to copy and a sample response.
OpenAPI files
For tools and generated clients, the same description is available in machine-readable OpenAPI format. You can download the files without a key:
| Scope | Address |
|---|---|
| Whole API | https://flowdata.one/en/docs/openapi.json |
| IP Geolocation | https://flowdata.one/en/docs/geolocation/openapi.json |
| Client Info | https://flowdata.one/en/docs/client-info/openapi.json |
| Maps | https://flowdata.one/en/docs/maps/openapi.json |
| Email Verifier | https://flowdata.one/en/docs/email-verification/openapi.json |
| YouTube | https://flowdata.one/en/docs/youtube/openapi.json |
| Media processing | https://flowdata.one/en/docs/media/openapi.json |
The German and Portuguese versions are under /docs/... and /pt/docs/..., for example https://flowdata.one/pt/docs/openapi.json.
To use a file:
- Load the file into your tool, such as an API client or a code generator.
- Add your FlowData key there as a bearer token. Creating a FlowData API key shows you how to get one.
- Send a first request to a free endpoint such as
GET /client-info.
Good to know
- To try out requests without building anything in, use the Playground.
- If you still use the old addresses under
creativeskyline.de/api/..., see Switching to api.flowdata.one. - Ready-to-use code samples are in Calling FlowData from PHP, JavaScript and Python.