API: Description, Methods & Examples

AppFollow API

You can use AppFollow API to create your own dashboards, real time tracking features and custom reports. Access to API is open for Free plan as well as for all Premium plans. 

API Base URL: http://api.appfollow.io

Messages' format — JSON 

Format requests — GET/POST

To get access to our API you need:

  • cid — client’s ID

  • api_secret — clients secret key

You can get these parameters in your personal account settings: http://watch.appfollow.io/settings/general

All data requests to AppFollow should be signed. Signature is following after "sign" parameter.

How to create signature

sign = md5(

sorted request parameters in following format:

parameter’s name and parameter’s meaning,

API method (URI path, e.g.: /test),

api_secret)

Signature example: sign = md5(cid=124ext_id=903655975/reviewsAppFollow-124-565cc38f8)

Handling Errors

In case there are any errors, server answer would be in JSON format, status 200 (except mistakes 502 и 504).

Error example: http://api.appfollow.io/sdsd

API Methods

1. App collections list

  1. /apps
  2. Required parameters:
    • cid — clients ID 

2. List of apps from the collection

  1. /apps/app
  2. Required parameters:
    • cid — clients ID 
    • apps_id — app collection ID:

3. Reviews

  1. /reviews

  2. Required parameters:

    • cid —  clients ID
    • ext_id — app external ID:
      for App Store — this is 9 digits identification number,
      for Google Play — this is bundle name
  3. Additional parameters:

    • page —  page number
    • date — date in format: YYYY-MM-DD
    • last_modified — date and time of last update in format: YYYY-MM-DD HH:MM:SS
    • country — for App Store
    • lang — language for Google Play

4. Ratings

  1. /ratings

  2. Required parameters:

    • cid —  clients ID
    • ext_id — app external ID:
      for App Store — this is 9 digits identification number, 
      for Google Play — this is bundle name
  3. Additional parameters:

    • date — date in format: YYYY-MM-DD
    • country — for App Store
    • lang — language for Google Play

5. Versions (any changes including meta-data)

  1. /versions
  2. Required parameters:
    • cid —  clients ID
    • ext_id — app external ID:
      for App Store — this is 9 digits identification number, 
      for Google Play — this is bundle name
  3. Additional parameters:
    • page —page number
    • country — for App Store
    • lang — language for Google Play

6. What's New (new versions)

  1. /whatsnew
  2. Required parameters:
    • cid —  clients ID

    • ext_id — app external ID:
      for App Store — this is 9 digits identification number, 
      for Google Play — this is bundle name

  3. Additional parameters:
    • page —page number
    • country — for App Store)
    • lang — language for Google Play)
    • last_modified — date and time of last update in format: YYYY-MM-DD HH:MM:SS

7. Rankings

  1. /rankings
  2. Required parameters:
    • cid —  clients ID
    • ext_id — app external ID:
      for App Store — this is 9 digits identification number, 
      for Google Play — this is bundle name
  3. Additional parameters:
    • page —page number
    • date — date in format: YYYY-MM-DD
    • country
    • device — e.g. iphone, ipad, android

8. Keywords

  1. /keywords
  2. Required parameters:
    • cid —  clients ID
    • ext_id — app external ID:
      for App Store — this is 9 digits identification number, 
      for Google Play — this is bundle name
  3. Additional parameters:
    • page —page number
    • date — date in format: YYYY-MM-DD
    • country
    • device — e.g. iphone, ipad, android

Request Examples

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.