API documentation
FlowData API
One base URL, one bearer key, data and media from six areas. You only pay for successful requests.
- Base URL
https://api.flowdata.one/v1
Areas
-
IP Geolocation API
Turn IP addresses into geographic information: city, country, time zone, currency and ISP, in German by default.
-
Client Info API
Browser, operating system, device type and IP details directly from the request headers, fully server-side without external services. Free.
-
Maps API
Address search, geocoding and route calculation through one interface.
-
Email Verifier API
Verify email addresses: syntax, mail server of the domain, disposable and catch-all domains, role addresses and mailbox through connected verification services.
-
YouTube API
Channel statistics for YouTube channels: subscribers, videos and views, by handle or channel ID.
-
Media Processing API
Asynchronous video, image and audio processing: scale, compress, watermark, thumbnails, course videos and audio tracks, with signed callbacks.
Authentication
Every request carries a FlowData key in the Authorization header. A key never belongs in the URL.
Prices
List prices. Only successful requests are billed; the prices that apply to your team are shown in the dashboard under Billing.
| IP Geolocation | 0.40 EUR | per 1,000 requests |
| Client Info | Free | |
| Maps · Search | 1.00 EUR | per 1,000 requests |
| Maps · Geocoding | 1.00 EUR | per 1,000 requests |
| Maps · Directions | 2.00 EUR | per 1,000 requests |
| Email Verifier | 9.00 EUR | per 1,000 requests |
| YouTube | 1.50 EUR | per 1,000 requests |
| Media processing · Video SD | 0.008 EUR | per started output minute |
| Media processing · Video HD | 0.014 EUR | per started output minute |
| Media processing · Video 4K | 0.03 EUR | per started output minute |
| Media processing · Audio | 0.004 EUR | per started output minute |
| Media processing · Image, thumbnail, poster | 0.001 EUR | per output |
OpenAPI
A machine-readable description per area and for the whole API, for example for generated clients.
Data sources and sharing
Some areas send request data to external providers:
- Maps: Mapbox, Google, MapTiler or Nominatim, depending on the query.
- Email verification: Emailable, Hunter and Leadrocks when our own checks are not conclusive.
- YouTube: the YouTube Data API.
- IP geolocation: local GeoLite databases from MaxMind, with no external call.
This product includes GeoLite Data created by MaxMind, available from https://www.maxmind.com.
Map data from Nominatim: © OpenStreetMap contributors, available under the Open Database License.