What the API does and who it is for
The Forward & Reverse Geocoding API wraps a globally distributed geocoding infrastructure built on OpenStreetMap (OSM) data into three clean REST endpoints. It targets a broad audience: frontend developers who need to drop a pin on a map from a user-typed address, backend engineers running batch geocoding jobs for logistics or fleet management, and anyone building address-autocomplete flows.
Because the underlying dataset is OSM — updated by millions of contributors and processed daily — coverage is global. The provider notes that rooftop-level accuracy is increasingly available in Europe and North America but should not be assumed everywhere. For urban addresses in well-mapped regions, results are generally reliable; for rural or developing-world addresses, it is worth testing on your specific data before committing to production.
One important compliance note: OSM data is licensed under ODbL, which requires you to attribute OpenStreetMap contributors in any public-facing product. The API enforces this through its terms, not technically — but skipping it puts you out of compliance.
Endpoint walkthrough
There are three endpoints, each serving a distinct geocoding mode.
GET /v1/search — free-form forward geocoding
This is the general-purpose search endpoint. It accepts a single free-text query and returns matching locations with coordinates. This is what you reach for when you want to let end users type anything — a street address, a city name, a landmark — and get back a ranked list of candidates. The provider explicitly recommends this endpoint over /v1/forward for user-facing autocomplete or freeform search experiences.
GET /v1/forward — structured forward geocoding
This endpoint accepts individual address fields (street, house number, postcode, city, country, and so on) rather than a single query string. It suits machine-to-machine workflows where the address is already decomposed — for example, normalising records in a CRM, verifying a postcode, or displaying a known address on a map. Because the input is structured, results tend to be more deterministic than the free-form search when your data is clean.
GET /v1/reverse — reverse geocoding
Pass a latitude and longitude; get back an address, place name, city, and country. This is the endpoint for device-tracking applications, fleet management dashboards, delivery confirmations, and any other scenario where you have coordinates and need a human-readable description of the location. The API returns varying levels of detail depending on what OSM has for that point.
Authentication is handled via the X-RapidAPI-Key header, which is standard for all APIs distributed through RapidAPI.
Pricing breakdown
The freemium model offers four plans. Here is how they compare:
| Plan | Monthly cost | Included requests | Rate limit | Overage |
|---|---|---|---|---|
| Basic | $0 | 1,000 / day | 3 req/s | — |
| Pro | $29 | 500,000 / month | 9 req/s | $0.0001 / request |
| Ultra | $95 | 100,000 / day | 24 req/s | — |
| Mega | $275 | 500,000 / day | 64 req/s | — |
A few things worth understanding before you pick a plan:
Basic gives you 1,000 requests per day with no credit card required. The provider is explicit that this is for private, hobby, or internal business testing only — not for production use in commercial products. At 3 req/s, you cannot drive any meaningful concurrent load through it.
Pro is the entry-level production tier. The 500,000 monthly cap works out to roughly 16,600 requests per day on average. Because Pro has overage pricing ($0.0001 per request beyond the cap), it is the most flexible option if your volume is unpredictable month to month. At $0.0001 per call, the effective cost per thousand is $0.10, which is straightforward to model.
Ultra shifts to a daily quota of 100,000 requests (about 3 million per month) with a higher rate limit of 24 req/s. This suits applications with consistent daily volume and moderate concurrency requirements.
Mega targets high-volume pipelines — up to 500,000 requests per day, roughly 15 million per month. The provider notes the plan is designed for evenly distributed traffic of around 42 req/s rather than bursty spikes. For volumes beyond this, a custom plan is available via RapidAPI messaging or [email protected].
Rate limits and batch geocoding considerations
The stated per-second limits are ceiling values. Under real-world conditions with client-side overhead, the provider's own testing found practical sustained throughputs somewhat lower: approximately 2 req/s on Basic, 6–7 on Pro, 18 on Ultra, and 48 on Mega before hitting HTTP 429 errors. Your actual numbers will vary based on network latency and client implementation.
If you are running batch geocoding — processing a large address file, for instance — the recommendation is to implement an exponential backoff or token bucket algorithm rather than hammering requests at the ceiling. A 429 response means the request is dropped, not queued, so without backoff you will lose data silently if you do not handle retries.
Practical use cases
- Address autocomplete: Use
/v1/searchas users type; debounce to stay under rate limits on lower-tier plans. - Map pin placement: Feed structured address records through
/v1/forwardto get coordinates for rendering on a map (the provider explicitly recommends pairing it with the MapTiles API). - Fleet and asset tracking: Poll or webhook device coordinates and resolve them to addresses via
/v1/reversefor driver dashboards or delivery confirmation screens. - Postcode retrieval and address normalisation: Pass partially known address fields to
/v1/forwardto fill in missing postal codes or standardise formatting before storing to a database. - Batch geocoding of existing records: Use the Pro or higher plan with a controlled request rate to convert a backlog of addresses to coordinates.
Limitations and things to check before integrating
- OSM attribution is mandatory. Build the attribution requirement into your UI or documentation from day one — retrofitting it later is painful.
- Rooftop accuracy is not universal. If precision matters for your use case (utility metering, property boundaries), test your target geography on the Basic plan before purchasing.
- No credit card required for Basic, which makes it genuinely useful for evaluation. Exhaust the 1,000 daily calls on real samples from your dataset before upgrading.
- Pro overage pricing is convenient but means your monthly bill is variable. Set a spending cap in RapidAPI's dashboard if budget predictability matters.
- The Mega plan is designed for steady traffic, not spikes. If your workload is bursty, factor that into plan selection — the Ultra plan at 24 req/s with a daily reset might be more appropriate than Mega for certain workloads.
Getting started
- Subscribe to the Basic plan on RapidAPI — no credit card needed.
- Grab your
X-RapidAPI-Keyfrom the RapidAPI dashboard. - Send a test request to
GET /v1/search?q=your+addresswith the key in the header. - Review result quality for your target geographies.
- Consult the full parameter reference at docs.geocodingapi.net — the data sheet above covers the three primary endpoints, but the docs detail all available query parameters for filtering, language preference, and result limits.
- Once you are satisfied with data quality, select the plan that matches your production request volume and concurrency requirements.