Data and media APIs for developers
Data you can measure. One API for location, addresses, email, YouTube and media.
One API key reaches six areas through the same REST API. You top up a euro balance, from 20.00 EUR, and pay per successful request. Errors and empty results cost nothing.
For businesses and self-employed professionals only
Data areas from 0.40 EUR per 1,000 requests, client info free.
/v1/geolocation/213.133.104.1?lang=en
curl "https://api.flowdata.one/v1/geolocation/213.133.104.1?lang=en" \
-H "Authorization: Bearer fd_YOUR_KEY"
{
"status": "success",
"continent": "Europe",
"continentCode": "EU",
"country": "Germany",
"countryCode": "DE",
"region": "BY",
"regionName": "Bavaria",
"city": "Nuremberg",
"district": null,
"zip": "90403",
"lat": 49.4527,
"lon": 11.0783,
"timezone": "Europe/Berlin",
"offset": 3600,
"currency": "EUR",
"isp": "Hetzner Online GmbH",
"org": "Hetzner Online GmbH",
"as": "AS24940 Hetzner Online GmbH",
"asname": "Hetzner Online GmbH",
"reverse": null,
"mobile": null,
"proxy": null,
"hosting": null,
"query": "213.133.104.1"
}
A real API response.
/v1/email-verification/max@example.com
curl "https://api.flowdata.one/v1/email-verification/max@example.com" \
-H "Authorization: Bearer fd_YOUR_KEY"
{
"email_address": "max@example.com",
"status": "invalid",
"source": "NA",
"result": "invalid",
"reason": "null_mx",
"checks": {
"syntax": true,
"mx": "null_mx",
"mail_provider": "other",
"disposable": false,
"role_account": false,
"catch_all": null
}
}
A real API response.
/v1/media/jobs
curl -X POST "https://api.flowdata.one/v1/media/jobs" \
-H "Authorization: Bearer fd_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"pipeline": "ugc_video",
"input": {
"url": "https://files.example.com/in.mov"
},
"outputs": {
"clean": {
"managed": true
}
},
"reference": "order-4711"
}'
{
"id": "01J8Z6Q4T0M3S1V7B2X9K5N4RD",
"status": "queued",
"pipeline": "ugc_video",
"preset": null,
"reference": "order-4711",
"priority": "normal",
"created_at": "2026-11-09T10:00:00Z",
"started_at": null,
"finished_at": null,
"input": {
"size": null,
"duration": null,
"width": null,
"height": null,
"video_codec": null,
"has_audio": null
},
"outputs": {
"clean": {
"status": "pending",
"target": "managed",
"size": null,
"width": null,
"height": null,
"duration": null,
"sha256": null,
"download_url": null,
"expires_at": null
}
},
"options": {},
"error": null,
"processing_seconds": null,
"cancel_requested": false,
"queue_position": 1
}
Fields and structure as in the API, the values are examples.
Prices per 1,000 successful requests
All prices- IP geolocation
- 0.40 EUR per 1,000 successful requests
- Client info
- Free
- Address search
- 1.00 EUR per 1,000 successful requests
- Geocoding
- 1.00 EUR per 1,000 successful requests
- Route
- 2.00 EUR per 1,000 successful requests
- Email verification
- 9.00 EUR per 1,000 successful requests
- YouTube statistics
- 1.50 EUR per 1,000 successful requests
- Media processing
- from 0.004 EUR per started output minute
List prices. Billed from your balance in euros, with no monthly fee and no packages. If other terms apply to your team, they are in the dashboard under billing.
Screenshot from the dashboard (German interface), with the example data of a fictional company.
Six areas, one key
Every area has its own endpoints under api.flowdata.one/v1, examples in the documentation and its own view in the dashboard.
-
IP geolocation
Country, city, coordinates, time zone and network for an IP or domain.
/v1/geolocation -
Client info
Device, browser and languages of the calling client. Free of charge.
/v1/client-info -
Maps
Address search, geocoding in both directions, routes.
/v1/maps/search -
Email verification
Check addresses before you send: valid, risky, invalid or unknown.
/v1/email-verification/{email} -
YouTube statistics
Subscribers, videos and views of public channels.
/v1/youtube/stats/{identifier} -
Media processing
Video, audio and images as asynchronous jobs.
/v1/media/jobs
You pay for what worked
Your team has a balance in euros that you top up from 20.00 EUR. Every request deducts from it, and the dashboard shows each booking. When the balance is empty, the API answers the next request with 402 and it costs nothing.
What is charged
- Every successful request to a data area, even when the answer comes from the result store.
- Every started minute of a finished video or audio output.
- Every finished image file, thumbnail and poster.
What is free
- Client info.
- Any request that ends in an error.
- A maps search with no results.
- An email check that ends in
unknownor finds no reachable verification service. - Media jobs and individual outputs that were not delivered.
Where your data goes
Not everything stays with us. For maps, email checks and YouTube we ask external providers, and only there. Here is what goes where, without detours.
| Area | The answer comes from | What is sent |
|---|---|---|
| IP geolocation | Local GeoLite databases from MaxMind | No call to a third party |
| Client info | Your request itself | No call to a third party |
| Maps | Mapbox, Google, MapTiler, Nominatim or Radar | Search term or coordinates to the provider that answers |
| Email verification | Our own checks, then Leadrocks, Hunter or Emailable | The address, only when our checks cannot decide |
| YouTube | Official YouTube Data API | Handle or channel ID |
| Media processing | Our servers (ffmpeg, ImageMagick) | Your files stay in our storage unless you give your own destination |
The full version with providers, retention periods and legal bases is in the privacy policy.
What teams use FlowData for
Four common ways to turn the endpoints into something whole.
-
List hygiene
Check email lists before sending, remove invalid addresses and lower bounces.
-
Location features
Detect origin, complete addresses, add store finders and routes to your own app.
-
Media pipeline
Transcode uploaded videos and images automatically, add watermarks and deliver them.
-
Channel analytics
Capture channel numbers regularly and feed them into your own reports.
For AI agents as well
Over MCP, agents like Claude or ChatGPT call the same endpoints, billed like any other request.
flowdata_geolocationflowdata_client_infoflowdata_maps_searchflowdata_maps_geocodeflowdata_maps_directionsflowdata_email_verificationflowdata_youtube_statsflowdata_media_create_jobflowdata_media_job_status
Frequently asked questions
fd_…) in the Authorization: Bearer header. You create keys in the dashboard and can give them their own spending limit and expiry date.
402 and charges nothing. Media jobs reserve the expected maximum when they are created and only bill what was delivered once they finish.
https://api.flowdata.one/v1. The documentation and OpenAPI files for each area are at flowdata.one/docs.