Frequently asked questions

Short answers to the questions we get most. If yours is not here, ask.

Getting started

Do I need an API key or an account to try it?

No. Any address gets 2,500 requests a day with no key and no account, on every endpoint and every drop-in host. Sign up (your name, an email address and a password) when you want keys of your own, a usage history, prepaid credit or an Unlimited package. Requests made without a key and requests made with a key from the same network share one daily allowance, so an account does not double the free 2,500.

What do I need to sign up?

Your name, an email address and a password. Nothing else: no company, no card. You can create more keys straight away and add credit or a package whenever you decide to.

How does credit work?

You top up a balance in advance with a pack of €10, €25, €50 or €100, by card or in crypto. Each request above your account's free 2,500 for the day takes €0.0001 from it. Credit is shared by all your pay-as-you-go keys, never expires, and nothing is charged automatically. When it is empty, requests above the free allowance are refused with 402 until you top up.

How do you take payment?

By card through Polar, or in crypto through NOWPayments: Bitcoin, Ethereum, USDT, USDC, Litecoin and many more. The amount is fixed at checkout and applied once the payment confirms. Everything is priced in euros.

What does the Unlimited package include?

A key with no per-request charges on every endpoint and every drop-in host, for €50 per month or €500 per year (two months free), usable from up to three IP addresses per rolling 24 hours. Each package has its own key; order several if you have several applications. See pricing.

Is there a referral programme?

Yes. Your dashboard has a referral link; 10% of every invoice paid by someone who signed up through it goes to a referral balance kept apart from your credit. Move it into credit whenever you like, or cash it out in crypto from €20. Cashouts are processed by hand and the transaction id appears in your dashboard.

Do you have coupon codes?

Sometimes: percentage or fixed discounts on a top-up or package, or bonus credit. Enter a code when you create the invoice or on any unpaid invoice before paying.

Access and limits

How is the free allowance counted?

Per account, per UTC day (all of its keys together), across all endpoints and drop-in hosts. Batch IP lookups and multi-point elevation calls count one per item. Refused requests and server errors are never counted.

What does the IP limit mean?

The first addresses to use a key each take a slot for 24 hours from their first request. A pay-as-you-go key has two slots, an Unlimited key three. When a slot's 24 hours end it frees on its own, so if two servers used the key at 02:00 and a third at 04:00, two slots are free again at 02:00 the next day and the third at 04:00. A request from a new address while every slot is held is refused with HTTP 403 and the code key_ip_limit; the response says when the next slot frees. For more machines, create more keys or add more packages.

Can I use a key in JavaScript on my website?

Yes, with a browser key. Create one in the dashboard for your website: it works only from scripts on that one website (with or without www.), has no IP limit, and each visitor may make 60 requests a minute. Give it a daily spending limit so a copied key cannot run up your credit. Server keys stay on your servers. Without a key, calls from scripts on a web page get 2,500 free requests a day per website.

Can I call the API from a browser or a mobile app?

From a web page, yes: CORS is enabled and the drop-in hosts accept the JSONP callback parameter their original providers do. Use a browser key, which works only from your website, or no key within the free allowance for web pages. A server key in client code is visible to everyone and would hit its IP limit after a couple of visitors. A mobile app has no website to check, so call the API from your own server and keep a server key there.

Is there a rate limit besides the daily allowance?

Not a fixed one today. Traffic that looks like a runaway loop or an attack may be slowed down, and we will tell you if that ever happens to a key of yours. Batch endpoints exist so that you do not need hundreds of requests a second.

What happens if my key leaks?

Revoke it in the dashboard and create a new one. Because of the IP limit a leaked key cannot be used from more than two or three machines a day anyway, and since credit is prepaid, nobody can run up a bill beyond the balance you chose to load.

Data and accuracy

What does the precision field mean?

It tells you what the returned point represents: house for a house number or house name (on the building or parcel, or placed along its street from its number range), street for the street itself when no house could be answered, postcode for the centre of a postal code area, and city, region or country for the centre of a town, region or country. If you asked for a house and got postcode, we could not find the house.

Which countries have house-level data?

The coverage page lists the best level available for each of 252 countries and territories, with filters by region and level. It is updated with every data release.

What data sources do you use?

Official address and postal data, internet registration and routing data for IP lookups, the standard time zone database and global terrain models, plus our own corrections. Each source is checked against the others before it goes in, and nothing is scraped from other geocoding services.

Can I store or cache results?

Yes. Results are yours to keep in your database, cache and display on any map, including maps from other providers. The only restriction in the terms is reselling the raw data as a geocoding service of your own.

How often is the data updated?

Address data is refreshed monthly, IP data weekly, time zone rules whenever IANA publishes a release, and elevation data when a better public model appears.

Do you support languages other than English?

Pass lang with an ISO 639-1 code and place names come back in that language where we have them, falling back to the local name. Address formatting follows the conventions of the country the address is in.

Compatibility

Are the drop-in hosts exact copies of the original APIs?

The paths, parameters and response shapes match each provider's public documentation so that existing client code parses the responses without changes. The data is ours, so values differ, and a few provider-specific features are not included. Each compatibility page lists the differences.

Does the Google Maps JavaScript drop-in show Google's map tiles?

No. The loader at gapi.mygeocode.com provides the google.maps namespace with our geocoder, autocomplete and elevation service behind it, and draws the map with free OpenStreetMap tiles. Street View, Directions and Places Details are not included. Loading the library does not count toward your quota. See JavaScript drop-ins.

Is My Geocode affiliated with Google, Microsoft, HERE or Mapbox?

No. Those names belong to their owners and are used here only to say which formats we can answer in.

Support

Is there an uptime guarantee?

Self-serve plans do not come with a contractual SLA. We run the API in more than one region and show live status at status.mygeocode.com. If you need a written SLA, talk to us.

How do I get support?

Email support@mygeocode.com. Paying accounts get a reply within one business day. Questions from free keys are answered too, as time allows.