Find local places with address, phone, website, rating, reviews, opening hours, amenities, categories, photos and distance. Send lat and lon, or a bbox: places outside the box are removed. One page per request. Failed requests are never charged.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
6 optional filters available.
string
Required
What to look for, for example cafe or pizza (max 499 characters).
coffee shops
number
Optional
Latitude of the search point. Send it with lon, or send bbox instead.
10
number
Optional
Longitude of the search point. Send it with lat, or send bbox instead.
10
string
Optional
Box as min_lat,min_lon,max_lat,max_lon. Only places inside the box are returned. Without lat and lon the search point is the center of the box.
example
string
Optional
Two-letter country code that sets the result region, for example DE. Default: US.
US
string
Optional
Region and language as ll-cc, for example de-de. Overrides country. Default: us-en.
example
integer
Optional
Maximum number of places, 1 to 20. Default: 20.
10
Errors
Handle these documented responses before retrying or showing customer-facing failures.
HTTP VALIDATION_ERROR
q is missing, or neither lat and lon nor bbox is sent, or a value is malformed. The request is not charged.
HTTP UPSTREAM_UNAVAILABLE
DuckDuckGo is temporarily unavailable. The request is not charged. Retry shortly.
Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.