API Access.

The Appbot API allows you to access the data programatically through a RESTful JSON API

(that's nerd speak for really awesome).

Make Appbot your own and upgrade.

Enquire about API

Rate Limits

Each team with a paid API account is allowed up to 250,000 requests per month with a maximum burst of 20 requests per minute, spread over that minute.

We reserve the right to adjust the rate limit for given endpoints to provide a high quality of service for all API customers.

Endpoints

Listing Your Apps

Example Response:

{
  "results":[
      {
        "id":68,
        "identifier":"650762525",
        "name":"7 Minute Workout",
        "store":"iOS"
      }
  ],
  "count":1
}
            

Fetching Reviews

Example Response:

{
   "results":[
      {
         "id":1329851,
         "author":"Tina (:())(:)",
         "rating":4,
         "body":"I like this quick workout after a run- it gives me the extra quick something I need.  you can do anything for  thirty seconds:)",
         "subject":"good quick workout",
         "published_at":"2015-08-13",
         "version":"3.1.2",
         "country":"USA",
         "translated_subject":null,
         "translated_body":null,
         "reply_text":null,
         "reply_date":null,
         "topics":[
           "Satisfied Users"
         ],
         "emotion":"happy",
         "device":null,
         "device_friendly_name":null,
         "os_version":null,
         "os_version_friendly_name":null
      },
      {
         "id":1329850,
         "author":"Ceomama",
         "rating":5,
         "body":"I'm a walker but it's hot outside. I liked this because you get cardio in. I can't do planks or push ups yet so it's not a beginner workout. Great though!",
         "subject":"Great workout",
         "published_at":"2015-08-13",
         "version":"3.1.2",
         "country":"USA",
         "translated_subject":null,
         "translated_body":null,
         "reply_text":null,
         "reply_date":null,
         "topics":[
         ],
         "emotion":"happy",
         "device":null,
         "device_friendly_name":null,
         "os_version":null,
         "os_version_friendly_name":null
      },
      ...
   ],
   "count":20,
   "page":1,
   "total_pages":2,
   "total_count":35
}
      

Emotion:

Emotion will be delighted, happy, impartial, angry, unhappy or null. null indicates no emotion could be detected.

Review Summary By Date

Example Response:

{
  results: [
    {
      published_date: "2015-09-05",
      review_count: 74,
      average_rating: 4.1
    },
    {
      published_date: "2015-09-06",
      review_count: 85,
      average_rating: 4
    },
    {
      published_date: "2015-09-07",
      review_count: 56,
      average_rating: 4.2
    }
  ],
  average_review_count: 71.7,
  average_rating: 4.1
}
      

Review Summary By Country

Example Response:

{
  results: [
    {
      country_name: "USA",
      review_count: 212,
      average_rating: 4.1
    },
    {
      country_name: "Bangladesh",
      review_count: 1,
      average_rating: 4
    },
    {
      country_name: "Russia",
      review_count: 514,
      average_rating: 4.2
    },
    ...
  ]
}
      

Review Summary By Rating

Example Response:

{
  results: [
    {
      rating: 1,
      count: 2898,
      reply_count: 0
    },
    {
      rating: 2,
      count: 481,
      reply_count: 0
    },
    {
      rating: 3,
      count: 608,
      reply_count: 0
    },
    {
      rating: 4,
      count: 1045,
      reply_count: 0
    },
    {
      rating: 5,
      count: 8037,
      reply_count: 0
    }
  ]
}
      

Rating Overview

Notes

Current version is only provided where versions are supplied by the applicable app store.

Example Response:

{
   "results":{
      "overall":{
         "average_rating":4.5767,
         "breakdown":[
            {
               "rating":1,
               "count":59,
               "reply_count":0
            },
            {
               "rating":2,
               "count":36,
               "reply_count":0
            },
            {
               "rating":3,
               "count":47,
               "reply_count":0
            },
            {
               "rating":4,
               "count":354,
               "reply_count":0
            },
            {
               "rating":5,
               "count":1375,
               "reply_count":0
            }
         ]
      },
      "latest_version":{
         "version":"3.5.2",
         "average_rating":3.75,
         "breakdown":[
            {
               "rating":1,
               "count":1,
               "reply_count":0
            },
            {
               "rating":2,
               "count":0,
               "reply_count":0
            },
            {
               "rating":3,
               "count":0,
               "reply_count":0
            },
            {
               "rating":4,
               "count":1,
               "reply_count":0
            },
            {
               "rating":5,
               "count":2,
               "reply_count":0
            }
         ]
      }
   }
}
      

Sentiment Breakdown

Example Response:

{
  results: {
    positive: 4728,
    negative: 510,
    neutral: 304
  }
}
      

Sentiment Timeline

Example Response:

{
  results: [
    {
      positive: 260,
      negative: 28,
      neutral: 21,
      published_at: "2015-07-29"
    },
    {
      positive: 918,
      negative: 88,
      neutral: 51,
      published_at: "2015-07-28"
    },
    ....
  ]
}
      

Versions

Example Response:

{
  results: [
    {
      version: "4.5.1",
      matches: 309,
      positive: 278,
      negative: 24,
      ave_rating: 4.5
    },
    {
      version: "4.6.1",
      matches: 685,
      positive: 604,
      negative: 66,
      ave_rating: 4.4
    },
    {
      version: "4.7.0",
      matches: 6,
      positive: 4,
      negative: 2,
      ave_rating: 3.8
    }
  ]
}
      

Sentiment Grade

Example Response:

{
  results: {
    grade: "A-",
    actions: [
      "4.5 star apps get more downloads."
    ]
  }
}
      

Popular Words

Example Response:

{
  results: [
    {
      word: "game",
      counter: 1555,
      positive: 1368,
      negative: 125,
      neutral: 62
    },
    {
      word: "love",
      counter: 747,
      positive: 710,
      negative: 19,
      neutral: 18
    },
    ...
  ],
  count: 50
}
      

Critical Words

Example Response:

{
  results: [
    {
      word: "bug",
      counter: 6,
      positive: 3,
      negative: 3,
      neutral: 0
    },
    {
      word: "crash",
      counter: 12,
      positive: 5,
      negative: 3,
      neutral: 4
    },
    ...
  ],
  count: 10
}
      

Topics

Example Response:

{
  results: [
    {
      id: 1,
      topic_name: "Advertising",
      matches: 52,
      positive: 12,
      negative: 31,
      ave_rating: 2.4
    },
    {
      id: 2,
      topic_name: "Apple Devices",
      matches: 35,
      positive: 18,
      negative: 14,
      ave_rating: 3.3
    },
    ...
  ],
  count: 43
}
      

Topics - Fetching Reviews

Example Response:

{
  results: [
    {
      id: 121172,
      author: "nickbomba",
      rating: 5,
      body: "Ottimo sostituto del web. Mi manca la possibilità di ricercare le inserzioni che accettano Paypal.",
      subject: "Ottima, ma continuate ad aggiungere funzioni",
      published_at: "2015-09-07",
      version: "3.6.1",
      country: "Italy",
      translated_subject: "Great, but we continue to add functions",
      translated_body: "Excellent substitute for the web. I miss the ability to search listings that accept PayPal.",
      reply_text: null,
      reply_date: null,
      topics: [
        "Advertising",
        "Payment",
        "Satisfied users"
      ],
      "emotion":"happy",
    },
    ...
  ],
  count: 2,
  page: 1,
  total_count: 2,
  total_pages: 1
}
      

Emotion:

Emotion will be delighted, happy, impartial, angry, unhappy or null. null indicates no emotion could be detected.

Custom Topics

Example Response:

{
  results: [
    {
      id: 101,
      filter_name: "Filter 1",
      matches: 441,
      positive: 309,
      negative: 98,
      ave_rating: 3.9
    },
    {
      id: 102,
      filter_name: "Filter 2",
      matches: 112,
      positive: 73,
      negative: 27,
      ave_rating: 3.7
    }
  ],
  count: 2
}
      

Custom Topics - Fetching Reviews

Example Response:

{
  results: [
    {
      id: 119626,
      author: "Dgriff813",
      rating: 5,
      body: "5⭐️⭐️⭐️⭐️⭐️ best app with no problems.",
      subject: "eBay",
      published_at: "2015-09-07",
      version: "3.6.1",
      country: "USA",
      translated_subject: null,
      translated_body: null,
      reply_text: null,
      reply_date: null,
      topics: [ ],
      emotion: 'happy',
    },
    ...
  ],
  count: 20,
  page: 1,
  total_count: 195,
  total_pages: 20
}
      

Emotion:

Emotion will be delighted, happy, impartial, angry, unhappy or null. null indicates no emotion could be detected.

Ratings

Provides information for all ratings and reviews, including per rating breakdown, average and total count information for Apple App Store and Google Play Store apps.

Statistics for both current version and all-time are available for Apple App Store apps, while only all-time information is available for Google Play apps.

Apple App Store apps require a specific country code to be provided and will return information for that country, whilst Google Play apps return global information.

Data is available from two endpoints, live and historical.

Live Data

Provides ratings data current as of time of request.

Example Response ( Apple) :

{
  "all_time": {
    "count": 2102662,
    "average": 4.472278949255753,
    "breakdown": {
      "1": 135931,
      "2": 47929,
      "3": 80540,
      "4": 261028,
      "5": 1577234
    },
    "version": null
  },
  "current_version": {
    "count": 757,
    "average": 4.110964332892999,
    "breakdown": {
      "1": 88,
      "2": 39,
      "3": 51,
      "4": 102,
      "5": 477
    },
    "version": "1.0"
  }
}
      

Example Response ( Google Play) :

{
  "all_time": {
    "count": 40050463,
    "average": 4.500339559120702,
    "breakdown": {
      "1": 1543931,
      "2": 802254,
      "3": 2255443,
      "4": 6918260,
      "5": 28530575
    },
    "version": null
  },
  "current_version": null
}
      

Historical Data (Ratings over Time) Beta

Provides ratings data collected by Appbot periodically within the given date range.

Example Response ( Apple) :

{
  "all_time": [
    {
      "created_at": "2017-01-01T01:30:00.000Z",
      "count": 1500,
      "average": 3.66666667,
      "breakdown": {
        "5": 500,
        "4": 400,
        "3": 300,
        "2": 200,
        "1": 100
      },
      "version": null
    },
    {
      "created_at": "2017-01-02T01:30:00.000Z",
      "count": 1600,
      "average": 3.625,
      "breakdown": {
        "5": 520,
        "4": 420,
        "3": 320,
        "2": 220,
        "1": 120
      },
      "version": null
    }
  ],
  "current_version": [
    {
      "created_at": "2017-01-01T01:30:00.000Z",
      "count": 150,
      "average": 3.66666667,
      "breakdown": {
        "5": 50,
        "4": 40,
        "3": 30,
        "2": 20,
        "1": 10
      },
      "version": "1.0"
    },
    {
      "created_at": "2017-01-02T01:30:00.000Z",
      "count": 160,
      "average": 3.625,
      "breakdown": {
        "5": 52,
        "4": 42,
        "3": 32,
        "2": 22,
        "1": 12
      },
      "version": "1.0"
    }
  ],
}
      

Example Response ( Google Play) :

{
  "all_time": [
    {
      "created_at": "2017-01-01T01:30:00.000Z",
      "count": 1500,
      "average": 3.66666667,
      "breakdown": {
        "5": 500,
        "4": 400,
        "3": 300,
        "2": 200,
        "1": 100
      },
      "version": null
    },
    {
      "created_at": "2017-01-02T01:30:00.000Z",
      "count": 1600,
      "average": 3.625,
      "breakdown": {
        "5": 520,
        "4": 420,
        "3": 320,
        "2": 220,
        "1": 120
      },
      "version": null
    }
  ],
  "current_version": null
}
      

Something else you need?

Chat to us today and let us know.
Send a message