Developer dashboard
You might need special API keys to access APIs of some Yandex services. The Developer Dashboard lets you obtain and manage API keys. The Developer Dashboard also provides the API for getting information about projects, services, and your account balance.
Obtaining and activating a key
You can obtain your first key when you log in to the Developer Dashboard. To do this, select a service. For each service, you'll need to fill out a form to specify your reason for using the API. If needed, you can add access keys to the service.
You can use a key to access the particular service API only after activating it (some services require moderation before the key can be activated). If activation hasn't been completed, this will be indicated next to the service name. The expected activation date (or additional conditions for activation) will be emailed to you after you fill out the form for connecting the service. If you haven't received an email with the expected activation date, please contact Developer Dashboard support.
For some services, keys are activated automatically. In this case, you can use the key immediately after you enable the service.
Which services can I get keys for?
You can use the keys obtained in the Developer Dashboard for the following APIs:
-
Yandex.Maps JavaScript API and Geocoder HTTP API (paid version).
You can get access to the paid version of the API under an offer (up to 1 million rubles) or under a contract (all service plans).
-
Yandex.Places API (paid version).
You can get access to the paid version of the API under an offer (up to 1 million rubles) or under a contract (all service plans).
-
Yandex.Maps Static API (paid version).
You can get access to the paid version of the API under an offer (up to 1 million rubles) or under a contract (all service plans).
-
MapKit Mobile SDK (paid version).
You can get access to the paid version of the API under an offer (up to 1 million rubles) or under a contract (all service plans).
-
Distance Matrix and Router API (paid version).
You can get access to the paid version of the API under an offer (up to 1 million rubles) or under a contract (all service plans).
-
Yandex.Payment API
Do I need a separate key for each service?
Yes, you need a separate key for each service. The key is created automatically when you select the API and fill out the form to connect it.
You can get an unlimited number of keys for each service. The service plan is calculated for the API as a whole. Conditions (limits) on the number of requests are shared by all keys.
Let's say you have 3 keys for the Yandex.Maps API, with 1000 requests per day available under the service plan. As soon as you make 200 requests with the first key and 800 requests with the second key, you've used up your limit and can't send requests with any of the other 3 keys.
Why isn't my key working?
Your key might not work in a particular service for one of the following reasons:
-
You haven't linked the service to the key.
-
The link between the key and the service hasn't been activated.
The terms of activation and the necessary additional information was automatically sent to your email after you filled out the form to link the service with the key. If you haven't got the email, please contact Developer Dashboard support.
-
The service has blocked your access to the API.
Yandex may block access to the API if the terms of use of the service have been violated. To find out why access has been blocked, click on the name of the blocked service.
You can block a key yourself if you don't plan to use it anymore.
When will my key expire?
A key's validity can only be limited for accessing a specific service. The service plan's expiration date is specified next to the service name. Your access can be blocked after this date.
To extend your plan, top up your balance according to your service plan or contact support for the service.
What do I do if I don't need a key anymore?
You can't delete a key that you've already obtained.
If you don't plan to use the key anymore, you can block it for one or more services.
How much does it cost?
You can obtain a new key in the Developer Dashboard for free, but using some service APIs may require payment.
The exact cost of using the API is determined by the service. You can find the latest service plans on the service pages listed above.
To see the plans in the Developer Dashboard, select an API and click Plans on the page that opens.
Key usage statistics
The Developer Dashboard provides statistics on your key usage per service. You can output your key usage data for any period, starting from the date when the key was linked to the service. Key usage statistics can be presented as a table or chart.
For some services, key usage statistics are collected, but not shown in the Developer Dashboard. To get statistics in this case, contact the service support.