/v1/maps/search
Search addresses and places
Searches for addresses and places. An existing result is served from our own database without asking a map service. A search without results is not billed.
Bearer fd_… 1.00 EUR per 1,000 successful requests
Query parameters
| Name | Type | Description | |
|---|---|---|---|
| q | string | Search term, up to 256 characters | |
| limit | integer | Number of results, 1 to 10, default 10 | |
| country | string | Country filter, ISO 3166-1 alpha-2, for example DE | |
| language | string | Language of the results, default de | |
| proximity | string | Preferred location as lng,lat | |
| types | string | Result types; the request then goes directly to Mapbox |
curl -X GET "https://api.flowdata.one/v1/maps/search?q=Berlin&limit=5" \
-H "Authorization: Bearer fd_YOUR_KEY" \
-H "Accept: application/json"
use Illuminate\Support\Facades\Http;
$response = Http::withToken('fd_YOUR_KEY')
->get('https://api.flowdata.one/v1/maps/search?q=Berlin&limit=5');
$data = $response->json();
const response = await fetch('https://api.flowdata.one/v1/maps/search?q=Berlin&limit=5', {
method: 'GET',
headers: {
'Authorization': 'Bearer fd_YOUR_KEY',
'Accept': 'application/json',
},
});
const data = await response.json();
import requests
headers = {
'Authorization': 'Bearer fd_YOUR_KEY',
'Accept': 'application/json',
}
response = requests.get(
'https://api.flowdata.one/v1/maps/search?q=Berlin&limit=5',
headers=headers,
)
data = response.json()
{
"success": true,
"addresses": [
{
"full_address": "Berlin, Deutschland",
"lat": 52.5200066,
"lng": 13.404954,
"place_name": "Berlin",
"postcode_name": "10115",
"country_name": "Deutschland",
"country_code": "DE"
}
],
"attribution": "NOTICE: © 2026 FlowSuite and its suppliers. All rights reserved. Use of this data is subject to the Terms of Service (https://creativeskyline.de/agb). This response and the information it contains may not be retained."
}