Following an app

POST Free /followed_apps/

You can create a new application by doing a POST to this endpoint. It will receive the information about the application you want to follow and either return an error object containing information about why you were not able to follow the application or contain the same information you passed with an extra id field containing an id we assign to this new followed app object.

Request for following an app

This allows you to follow an app. You have to pass a JSON formatted body with information about the application you want to follow.

Header parameters

X-AppTweak-Key:

Your AppTweak API Key.

Query parameters

store: string Required

To which store the app you want to follow belongs to: itunes or google

country: string Required

The two letter country code (ISO Alpha-2) to follow the app in.

Get the list of our country codes, here.

language: string Required

The two letter language (ISO Alpha-2) you want to fetch the application in.

Get the list of our language codes, here.

device: string Required

The device of the application you want to follow.

iphone, ipad or android

application_id: Required

ID of the application you want to follow in the respective store.

Itunes applications have numeric ids while Google Play ids are strings separated by dots

POST /followed_apps/

Request example

POST /followed_apps {"store": "itunes", "device": "iphone", "country_code": "us", "language": "us", "application_id": "1229021451"}

cURL example

curl -X POST -H "X-Apptweak-Key: ${API_KEY}" -H "Content-Type: application/json" -d '{"store": "itunes", "device": "iphone", "country_code": "us", "language": "us", "application_id": "1229021451"}' https://api.apptweak.com/followed_apps

Response for following an app

The response for following an app will contain information about the app you asked to follow if the request suceeds. If the request fails, it will contain an error object informing why the request failed.

Object properties

id: string

An id generated by us to identify this followed app uniquely

store: string

To which store the app belongs to: itunes or google

country: string

The two letter country code (ISO Alpha-2) of the followed app

language: string

The two letter language (ISO Alpha-2) of the followed app

device: string

The device of the application you are following

application_id:

ID of the application you are following.

Response Example

{
  "content": {
    "id": "47592be8-aecd-431a-913b-104238fdf50f",
    "store": "itunes",
    "application_id": "1229021451",
    "country_code": "us",
    "language": "us",
    "device": "iphone"
  },
  "metadata": {
    "request": {
      "path": "/api/followed_apps",
      "params": {
        "application_id": "1229021451",
        "country_code": "us",
        "language": "us",
        "device": "iphone",
        "store": "itunes"
      }
    },
    "performed_at": "2019-07-31T15:35:21.504Z"
  }
}