AppFollow API: Description, Methods & Examples

API from AppFollow helps you reply to reviews, follow keywords changes and ranking, and track apps' updates no matter what tools you use. The API has the ready-made methods to quickly access all data. Wherever you are, you have everything you need to grow your mobile app and get more customers.

Settings

Documentation: https://appfollow.docs.apiary.io/

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

Messages' format: JSON

Requests’ format: GET/POST

Instruction on how to access data using POSTMAN is below.

Access to AppFollow API

1. Go to your personal account settings and get:

• api_secret — client’s secret key

2. Choose an API method, create a request (optional: add additional parameters).

3. Add a signature to your request after "sign" parameter.

4. You’re done now!

Postman

To use Postman API Client:

1. Create a Postman request without the 'sign' parameter. 

The cid parameter can be found in your account settings. 

For example, for method #1. App collections list the request should look like this: https://api.appfollow.io/apps?cid=******

2. Go to the tab 'Authorization' and select the type 'Basic Auth'.

3. Enter the api_secret into the 'Username' field (the api_secret should be copied from the account settings).

4. Click ‘Send’ to process the request and receive a response from the server.

5. Configure all needed endpoints in the same way. The cid and api_secret parameters of request should be exactly like in your account settings. Otherwise, your request will be rejected by the server. 

Other access methods (creating a signature)

Signature consists of 3 parts:

• Parameters (Name=Value): required and additional;

Note: sort parameters by Name (A-Z);

Example: apps_id=, cid=, date_from= etc.;

• API method (URI path).

Example: /ratings;

• api_secret.

Signature examples:

sign = md5(cid=124ext_id=903655975/ratingsYOUR_API_SECRET)

sign = md5(apps_id=1111cid=124/ratingsYOUR_API_SECRET)

Request example:

https://api.appfollow.io/ratings?cid=966&ext_id=618783545&sign=2dd47bc7a0328cf61ace906f433c3541

API request to-do list:

• Create a signature
• Encode it here: http://7thspace.com/webmaster_tools/online_md5_encoder.html
  https://www.md5online.org/md5-encrypt.html
• Insert encoded signature into the final request.

Methods

Here we gathered all ready-to-use methods you may need:

1. App Collections List
2. Apps of the Collection
3. Reviews
4. Reviews Summary
5. Review Reply* (required to reply to reviews)
6. Review Tags Update
7. Review Bug Trackers Update
8. Review Notes Update
9. Ratings
10. Versions (any changes, including metadata)
11. What's New (new versions)
12. Rankings
13. Keywords
14. Keywords Edit
15. ASO Keyword Research
16. ASO Search
17. ASO Search Ads
18. ASO Trending
19. ASO Reports
20. Stat Reviews
21. Stat Reviews Rating
22. Stat Reviews by Version
23. Stat Reviews Replies
24. Stat Replies Speed
25. Collection Reviews
26. Review Custom Status (private beta)
27. Ratings Export
28. Featured Reviews
29. Replies Statistics
30. Countries
31. ASO Reports Countries
32. Featured Apps (for App Store)
33. Public Top Charts
34. Report a concern
35. Downloads & Revenue
36. Subscriptions Report
37. Add collection (Advanced API)
38. Remove collection (Advanced API)
39. Add app (Advanced API)
40. Remove app (Advanced API)
41. Users List
42. Add user (Advanced API)
43. Remove user (Advanced API)
44. Update user (Advanced API)
45. Reviews Semantic Tags (Advanced API)

In the Documentation we've included request examples, you just need to copy them.

You will also find the response examples:

Genre_id

Country(iOS)/Language(Android)

SDK

• JavaScript: https://github.com/AppFollow/appfollow-api-js
• Python: https://github.com/AppFollow/appfollow-api-python

Handling Errors

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

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