Tracked Applications - Create

Start tracking an application with the API.

Price

DatapointDescriptionCredits/request
-The tracking entry created, with its id1


Good to know

• A tracked app is defined by an app id, country code, language code and device. Following the same app in Google Play in the US for English & Spanish will count as 2 tracked apps.
• Tracking an app will prioritize its data retrieval. The result may take up to 24 - 48 hours to show after you start following the app.
• Tracked apps are linked to your user and API token, and the number of apps that you're allowed to track depends on your API plan.

Body Params

The application to start tracking. application_id is mandatory. When omitted, country defaults to us, device is taken from the app id's store and language from that store and country.

string
required

App ID to be tracked. Only 1 app ID can be passed.

string
Defaults to us

Two-letter country code (us, gb, fr). Accepted values: GET /api/public/apptweak/countries with store=ios or store=android. Defaults to us when omitted.

string

AppTweak language code, not always ISO: US English is us, US Spanish sp. Accepted pairs: GET /api/public/apptweak/languages with store=ios or store=android. Defaults to the country's default language.

string
enum

The device for which the application will be tracked. If not specified, the default device for the provided application_id's store will be used.

Allowed:
Responses

401

Unauthorized. Unknown or missing API token.

403

Forbidden. Returned when there are not enough credits to perform the request, or when the account has already reached the maximum number of tracked applications allowed by its API plan.

422

Validation error. Returned when the request body is empty or contains a property other than application_id, country, language and device, when the application is already tracked, or when the tracked application cannot be created with the provided values.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json