コンテンツにスキップ

App List API

このコンテンツはまだ日本語訳がありません。

Version 1.0 / March 2017

Advertisers use this API to create a set of apps to later be targeted by or excluded from a campaign. This replaces the old whitelist/blacklist API that will soon be deprecated.

Targeting APIs

To use these APIs, send an HTTP request to the following URL:

https://api.applovin.com/applists/«command»

The following table briefly describes the various command values and their purposes:

CommandDescription
createCreates a new app list
listDisplays the current apps-lists or the defined apps
appendAdds new apps to an existing list
deleteDeletes a given app list
deleteAppsRemoves given apps from a specific list

Authentication

This API requires that you include an API key as a query parameter (api_key) in the request:

https://api.applovin.com/applists/command?api_key=«management-key»

You can find this Management Key in the Keys tab of your account page. If the Management Key is not visible, please open a ticket here and request one be generated for you.

Errors

This API indicates errors by means of HTTP status codes:

HTTP Response CodeDescription
200Success.
400The request was not formatted properly; it was missing data or had invalid data.
403Authentication failed. Check the validity of the API Key.
404The App List ID specified does not exist.
406For create, an active list with the same name exists already.
500Service Unavailable.

create

The first step when you submit an app list is to create an empty list. To create a new list, make an HTTP request to

https://api.applovin.com/applists/create?api_key=«management-key»&name=«list-name»

The create API accepts the following fields passed as URL-encoded query parameters

NameTypeDescriptionRequired
nameStringName of the listYes (must be alphanumeric, _-+, or URL-encoded space)
descriptionStringDescription of the listNo

Response

The response is JSON-formatted:

NameTypeDescription
app_list_idStringID of the audience

Example Request

Terminal window
curl "https://api.applovin.com/applists/create?name=High%20Performing%20Apps&api_key=«management-key»"

Example Response

{
"app_list_id": "fce0b41a0849706bd0fbbe181e61f419"
}

list

To get a list of all of the current app lists, make an HTTP request to the list endpoint:

https://api.applovin.com/applists/list?api_key=«management-key»

Response

The response is JSON-formatted:

NameTypeDescription
codeInteger200 for success
app_listsList of ObjectsA list of objects containing information about an app list
app_list_idStringID of the list
nameStringName of the list
descriptionStringDescription of the list
app_countLongNumber of apps that are part of the list
countLongNumber of lists returned

Example Request

Terminal window
curl "https://api.applovin.com/applists/list?api_key=«management-key»"

Example Response

{
"code": 200,
"app_lists": [
{
"app_list_id": "dab2d1297d35592597b0eee016e92baa",
"name": "High Performing Apps",
"description": "Apps that exceed our ROAS goals",
"app_count": 3
}
],
"count": 1
}

list (with app list ID)

To get the list of all apps in a specified app list, make an HTTP request to the list endpoint with an app_list_id parameter:

https://api.applovin.com/applists/list?api_key=«management-key»&app_list_id=«app-list-ID»`

Query Parameters

NameTypeDescriptionRequired
app_list_idStringID of the app list returned from the create or list endpointYes

Response

The response is JSON-formatted:

NameTypeDescription
codeInteger200 for success
appsList of ObjectsA list of objects containing all apps in the list
applicationStringExternal application ID
countLongNumber of apps that are part of the list

Example Request

Terminal window
curl "https://api.applovin.com/applists/list?api_key=«management-key»&app_list_id=fce0b41a0849706bd0fbbe181e61f419"

Example Response

{
"code": 200,
"apps": [
{
"application": "a0849706bda0849706bd"
},
{
"application": "4326af2346b2l46e2346"
}
],
"count": 2
}

append

To append apps to an existing list, make an HTTP POST request to:

https://api.applovin.com/applists/append?api_key=«management-key»&app_list_id=«app-list-ID»

Query Parameters

NameTypeDescriptionRequired
app_list_idStringID of the app list returned from the create or list endpointYes

Post Body

The append endpoint accepts a newline-separated list of IDs in a POST request:

NameTypeDescriptionRequired
List of appsList of StringsA newline-separated list of external application IDsYes

Response

The response is JSON-formatted:

NameTypeDescription
app_list_idStringID of the app list
processed_appsIntegerNumber of valid apps in this request
failed_appsIntegerNumber of invalid apps in this request

Example Request

Terminal window
curl -X POST --data-binary @apps.txt "https://api.applovin.com/applists/append?app_list_id=«app-list-ID»&api_key=«management-key»"

Where the contents of the file apps.txt is:

a0849706bda0849706bd
4326af2346b2l46e2346

Example Response

{
"app_list_id": "dab2d1297d35592597b0eee016e92baa",
"processed_apps": 2,
"failed_apps": 0
}

delete

To delete an app list, make an HTTP request to

https://api.applovin.com/applists/delete?api_key=«management-key»&app_list_id=«app-list-ID»

Query Parameters

NameTypeDescriptionRequired
app_list_idStringID of the app list returned from the create or list endpointYes

Response

There is no response body for the delete endpoint. On success it returns HTTP Response code 200.

Example Request

Terminal window
curl "https://api.applovin.com/applists/delete?app_list_id=«app-list-ID»&api_key=«management-key»"

deleteApps (remove apps from a list)

To delete apps from an existing list, make an HTTP POST request to:

https://api.applovin.com/applists/deleteApps?api_key=«management-key»&app_list_id=«app-list-ID»

Query Parameters

NameTypeDescriptionRequired
app_list_idStringID of the app list returned from the create or list endpointYes

Post Body

The append endpoint accepts a newline-separated list of IDs in a POST request.

NameTypeDescriptionRequired
List of appsList of StringsA newline-separated list of external application IDsYes

Response

The response is JSON-formatted:

NameTypeDescription
app_list_idStringID of the app list
processed_appsIntegerNumber of apps deleted from the list in this request
failed_appsIntegerNumber of invalid apps in this request

Example Request

Terminal window
curl -X POST --data-binary @apps.txt "https://api.applovin.com/applists/deleteApps?app_list_id=«app-list-ID»&api_key=«management-key»"

Where the contents of the file apps.txt is:

a0849706bda0849706bd
4326af2346b2l46e2346

Example Response

{
"app_list_id": "dab2d1297d35592597b0eee016e92baa",
"processed_apps": 2,
"failed_apps": 0
}

Targeting Campaigns to an App List

Once an app list is created and has apps associated with it, it will appear as an option in the Application section of the Edit Targets page for all campaigns.

Example Postman Collection

Download AppLovin App Lists Postman Collection