Post API

Allows you to send events using an HTTP request to the AppMetrica server. Uploaded data is displayed in AppMetrica reports.

You can upload events in request parameters or in the request body (in the csv format). Data passed via the SDK and the API is merged if you passed the same value of profile_id or appmetrica_device_id.

Uploaded data is added to the data that has been received from the SDK. Data that is uploaded via the Post API is synced with the other data every 4 hours.

Accessing the API

To work with the Post API, you need to get the Post API key in the Settings section of your application.

You should pass the token in every API request in the post_api_key parameter.

Hosts

You should send requests to the https://api.appmetrica.yandex.com host. For example:

https://api.appmetrica.yandex.com/logs/v1/import/events

or

https://api.appmetrica.yandex.com/logs/v1/import/events.csv

Restrictions

The Post API has the following restrictions on loading data:

  • You can upload events only if the difference between the event date (event_timestamp) and the upload date is no more than seven days.
  • You can upload events for identifiers that were previously sent via the SDK.
  • You can upload events for profiles that have been updated at least once in the past six months.
    Note. AppMetrica removes the profile for which data is not uploaded for more than six months.