Followed Apps and Competitors

Get the applications followed in the selected workspaces, with the competitors tracked against each of them, one entry per store, country, language and device the application is followed in.

Price

DatapointDescriptionCredits/request
followed application objectHash containing the application id and name, the store, country, language and device it is followed in, and its competitors.0


In AppTweak an application is followed in a context, not in the absolute: the same app can be followed on the App Store in the United States and on Google Play in France, and each of those is a separate entry with its own competitors. The response keeps that structure, one entry per context, grouped by workspace.

The filters are all optional and all narrow the same list: application_ids, stores, country_codes, language_codes and devices. metadata.response.filters echoes the ones that were applied. Applications whose metadata can no longer be resolved are omitted.

Query Params
workspace_ids
array of int32s
required

Comma-separated list of workspace IDs to read. At least one is required; the Workspaces endpoint lists the IDs your user has access to.

workspace_ids*
application_ids
array of strings

Comma-separated list of store application IDs (iOS numeric ID or Android package name). Restricts the response to those applications.

application_ids
stores
array of strings

Comma-separated list of stores to keep, among google, itunes.

stores
Allowed:
country_codes
array of strings

Comma-separated country codes (us,gb); accepted values: GET /api/public/apptweak/countries with store=ios or store=android. Keeps only the entries in those countries.

country_codes
language_codes
array of strings

Comma-separated AppTweak language codes, not always ISO: US English is us, US Spanish sp. Accepted values: GET /api/public/apptweak/languages with store=ios or store=android. Keeps only the entries in those languages.

language_codes
devices
array of strings

Comma-separated list of devices to keep, among android, iphone, ipad.

devices
Allowed:
Responses

401

Unauthorized. Unknown or missing API token.

403

Forbidden. Not enough credits to perform the request.

422

Validation error. Returned when a parameter is invalid.

429

Rate limit exceeded: 20 requests per minute on this endpoint, 60 per 10 seconds across the API. Retry with backoff.

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