Chocodata
data_object Structured JSON endpoint Local & Directories

Nominatim Scraper API

Access Nominatim search data using our Nominatim Scraper API. One API request returns clean, structured JSON while we get past CAPTCHAs, IP rate limiting, IP blocking, and headless-browser detection with rotating residential proxies. Get back fields like display name, latitude and longitude, OSM type and ID, place class and type as structured JSON.

check_circle 1,000 free requests/month. No credit card. Residential proxies.

Request
curl "https://api.chocodata.com/api/v1/nominatim/search?api_key=YOUR_API_KEY&q=Eiffel+Tower"
JSON Response
live sample 200 OK
{
  "query": "Eiffel Tower",
  "page": 1,
  "total_results": 2,
  "results[0].position": 1,
  "results[0].id": "98183338",
  "results[0].title": "Eiffel Tower, 5, Avenue Anatole France, Quartier du Gros-Caillou, 7th …",
  "results[0].url": "https://www.openstreetmap.org/way/5013364",
  "results[0].lat": 48.8582599,
  "results[0].lon": 2.2945006,
  "results[0].category": "man_made",
  "results[0].class": "man_made",
  "results[0].type": "tower",
  "results[0].place_rank": 30,
  "results[0].addresstype": "man_made",
  "results[0].importance": 0.6205937724353116,
  "results[0].osm_type": "way",
  "results[0].osm_id": "5013364",
  "results[0].place_id": "98183338"
  // + more fields
}
lan 235 targets
vpn_lock Residential proxy network
data_object Structured JSON
redeem 1,000 free requests/mo

Everything you need to scrape Nominatim

You never expose your own IP, you get validated JSON instead of raw HTML, and the free tier covers nominatim scraper at 1,000 requests a month with no card required.

data_object

Clean structured JSON

Fields come back parsed and validated, not a dump of HTML. Store Nominatim search records straight into your database instead of writing brittle selectors for nominatim scraper.

gpp_good

Bypasses CAPTCHAs and anti-bot defenses

We get past CAPTCHAs, IP rate limiting, IP blocking, and headless-browser detection on Nominatim using rotating, country-matched residential proxies, so requests look like real users and your own IP stays private.

api

One API call

The Nominatim Scraper API is one simple API call. The same key works across our whole web scraping API: all 235 targets, any language, no SDK required.

travel_explore

Geo-targeting and JS rendering

Pass a country for proxy geo-targeting and turn on JavaScript rendering when a Nominatim page needs it. nominatim data api handles dynamic content and region-locked results.

Scrape Nominatim in one API request

Send one API request to the Nominatim Scraper API and read back typed fields. Chocodata routes the request through country-matched residential proxies, retries soft blocks, and parses the page, so nominatim api stays reliable as Nominatim's markup shifts.

  • check_circle Validated, parsed JSON fields
  • check_circle Residential-proxy infrastructure
  • check_circle Only successful 2xx responses are billed
Get your free API key

Request

curl "https://api.chocodata.com/api/v1/nominatim/search?api_key=YOUR_API_KEY&q=Eiffel+Tower"

Response

{
  "query": "Eiffel Tower",
  "page": 1,
  "total_results": 2,
  "results[0].position": 1,
  "results[0].id": "98183338",
  "results[0].title": "Eiffel Tower, 5, Avenue Anatole France, Quartier du Gros-Caillou, 7th …",
  "results[0].url": "https://www.openstreetmap.org/way/5013364",
  "results[0].lat": 48.8582599,
  "results[0].lon": 2.2945006,
  "results[0].category": "man_made",
  "results[0].class": "man_made",
  "results[0].type": "tower",
  "results[0].place_rank": 30,
  "results[0].addresstype": "man_made",
  "results[0].importance": 0.6205937724353116,
  "results[0].osm_type": "way",
  "results[0].osm_id": "5013364",
  "results[0].place_id": "98183338"
  // + more fields
}

Parameters

Pass these as query-string values alongside your API key. Only the required ones are mandatory; the rest have sensible defaults.

Parameter Type Required Example
q string required Eiffel Tower
limit number optional 20
countrycodes string optional us
accept-language string optional laptop

What you can build with Nominatim data

Once the scraping API returns Nominatim search data as clean JSON, these are the patterns teams reach for most.

check_circle

Data Aggregation

Pull Nominatim search records into your own warehouse and analyze them on your terms.

check_circle

Market Intelligence

Track Nominatim search data over time to spot market shifts before competitors do.

check_circle

Competitor Monitoring

Watch rivals on Nominatim and alert your team when prices, ranks, or listings change.

check_circle

Lead Generation

Turn Nominatim search data into targeted lead lists and feed them into your CRM.

Why developers pick Chocodata for Nominatim

bolt

Fast at the tail

Median 2.6 s per request with multi-tier retry, so latency stays predictable even when Nominatim fights back.

verified_user

Parity-checked output

Fields are regression-tested on every extractor change, so 2xx responses match the live page.

hub

One key, 235 targets

The same scraping API key that scrapes Nominatim works across every other target, with official Node, Python, and Go SDKs.

Simple pricing that scales with you

Start free with 1,000 requests a month and 5,000 credits, no credit card. Scale on monthly plans from $19, or top up pay-as-you-go at $0.90 per 1,000 successful requests. Only successful 2xx responses are billed, and every plan covers the full scraping API: all 235 targets and every endpoint.

Free

$0

Forever free on signup

  • check_circle1,000 requests / month (5,000 credits)
  • check_circle10 concurrent requests
  • check_circleAll 237 targets
  • check_circleFull dashboard + analytics
  • check_circleTop-up at $0.90 / 1k
  • check_circleCommunity support
Start free
Most popular

Vibe

$19 / month

$0.70 / 1k effective

  • check_circle27,000 requests / month (135,000 credits)
  • check_circle30 concurrent requests
  • check_circleAll 237 targets + content-language
  • check_circleCountry-matched residential IPs
  • check_circlePer-API-key usage tracking
  • check_circleTop-up at $0.90 / 1k
  • check_circleEmail support (1 business day)
Get Vibe

Pro

$49 / month

$0.60 / 1k effective

  • check_circle82,000 requests / month (410,000 credits)
  • check_circle50 concurrent requests
  • check_circlePriority routing queue
  • check_circleCountry-matched residential IPs
  • check_circleTeam seats (up to 5)
  • check_circleTop-up at $0.90 / 1k
  • check_circleEmail + chat support
Get Pro

Custom

$100-$2k / month

Flat $0.50 / 1k effective at every level

  • check_circle200k - 4M+ requests / month
  • check_circle100-500+ concurrent requests
  • check_circlePriority queue (highest)
  • check_circlePremium proxy pool + SLA on request
  • check_circleUnlimited team seats
  • check_circleWire / invoice / annual PO
  • check_circleDedicated Slack channel
Pick Custom level

Pay-as-you-go top-up

$0.90 / 1,000 successful requests

Available on every plan including Free. Top up any time when included credits run out. Only 2xx responses charged. Balance never expires.

Nominatim Scraper API FAQ

Is it legal to scrape Nominatim?

expand_more
Scraping publicly accessible Nominatim data is generally legal in the US under the Ninth Circuit's hiQ v. LinkedIn ruling, which held that scraping public web data does not violate the Computer Fraud and Abuse Act. It does not override Nominatim's own Terms of Service, which are a contract matter, so check those for your use case and comply with data laws such as GDPR. This is general information, not legal advice.

How do I scrape Nominatim without getting blocked?

expand_more
You scrape Nominatim without getting blocked by letting Chocodata route every request through country-matched residential proxies with automatic rotation and retries. Because the traffic looks like real users from real networks, the Nominatim Scraper API gets through anti-bot defenses that block datacenter IPs, and you never expose your own address.

What data does the Nominatim Scraper API return?

expand_more
The Nominatim Scraper API returns Nominatim search data as structured JSON: the core fields parsed from the page, ready to store or query. Exact fields depend on the search type, and only successful (2xx) responses are billed.

How much does the Nominatim Scraper API cost?

expand_more
The Nominatim Scraper API costs nothing to start: the Free plan includes 1,000 requests per month (5,000 credits) across all 235 targets. After that, monthly plans begin at $19, or you top up pay-as-you-go at $0.90 per 1,000 successful requests. One request is 5 credits, and non-2xx responses are never charged.

Do I need a Nominatim account or login?

expand_more
No Nominatim account or login is required. The Nominatim Scraper API reads publicly accessible search pages, so you only need a Chocodata API key, not Nominatim credentials. Pages that sit behind a Nominatim login are out of scope.

Related scraper APIs

Start scraping Nominatim for free

1,000 free scraping API requests on signup across all 235 targets. No credit card required.