Titles API

“Title” is the entity of your application in ironSource promote section.

The Title API allows you to get the list of titles (bundles) linked to your account.

Authentication

Bearer API authentication

Get Titles

Description: Use this API to retrieve a list of all of your titles (bundles). The response will include the following fields: id, bundleId, os, name.

Required Parameters: None

Method: GET

Endpoint: https://api.ironsrc.com/advertisers/v2/titles?

Parameters:

Name
Mandatory
Data type

Description

os No String Filter titles of a specified os. (Options: ios, android).
searchTerm No String Filter by the name or partial name of the title.
requestId No Number Used for paginated requests.
resultsBulkSize No Number Used for paginated requests.
pageNumber No Number Used for paginated requests.

Request Example

Get https://api.ironsrc.com/advertisers/v2/titles?

Response example

{
  "titles": [
    {
      "id": 113366,
      "bundleId": "com.yourcompany.MiniGame",
      "os": "android",
      "name": "Gaming mania"
    },
    {
      "id": 225566,
      "bundleId": "com.yourcompany.BestGame",
      "os": "ios",
      "name": "The Best Game"
    },
    {
      "id": 773366,
      "bundleId": "com.yourcompany.MusicGame",
      "os": "ios",
      "name": "Guitar Music"
    },
    {
      "id": 667722,
      "bundleId": "com.yourcompany.zombie2",
      "os": "android",
      "name": "Zombie Games"
    },
    {
      "id": 123456,
      "bundleId": "com.yourcompany.DancingWar",
      "os": "android",
      "name": "Dancing War"
    }
  ],
  "totalResultsCount": 5,
  "requestId": "MzUzMjIuODI5OTk5OS41LjI5"
}

For better performance – we strongly recommend to work with pagination requests in all cases,

To do so you should use ‘resultsBulkSize’ parameter – This parameter will limit the amount of the results you get in the response.

In order to get the next bulk of results, use ‘pageNumber’ parameter, combined with the ‘requestId’ parameter – which is received in the first response.

 

Pagination request Example URL:

In the first request you set the results number limitation: https://api.ironsrc.com/advertisers/v2/titles?resultsBulkSize=2

Pagination response example:

{
  "titles": [
    {
      "id": 113366,
      "bundleId": "com.yourcompany.MiniGame",
      "os": "android",
      "name": "Gaming mania"
    },
    {
      "id": 225566,
      "bundleId": "com.yourcompany.BestGame",
      "os": "ios",
      "name": "The Best Game"
    }
  ],
  "totalResultsCount": 5,
  "requestId": "MzUzMjIuODI5OTk5OS41LjI5"
}

For the next pages, use the requestId from the response and the required pageNumber.

For example: https://api.ironsrc.com/advertisers/v2/titles?requestId=MjE2MDkzLjUwMTEwMC4yLjE5&pageNumber=2

Keep increasing the ‘pageNumber’ param to get the following pages.

 

Create Titles

Description: Use this API to create title on ironSource platform.

Note: This function is not supported via API at the moment.