HELP CENTER

How to receive apps from various app collections on Google Play and App Store?

Both Google Play and App Store have various app collections. Using the Google App List and Apple App List endpoints of App Data API, you can receive applications from any app collection on the Google Play or App Store platform.

Receiving apps from Google Play collections

1 Call the Google App List Task POST endpoint.

POST https://api.dataforseo.com/v3/app_data/google/app_list/task_post

2 Specify the app collection from which you wish to collect applications in the app_collection field.

Possible values: featured, topselling_paid, topselling_free, topselling_new_free, topselling_new_paid, topgrossing, movers_shakers.

3 Specify the location parameters by adding the location_name or location_code field to the POST body.

You will receive the full list of available locations by making a separate request to the Locations endpoint.

GET https://api.dataforseo.com/v3/app_data/google/locations

4 Specify the language parameters by adding the language_name or language_code field to the POST body.

You will receive the full list of available languages by making a separate request to the Languages endpoint.

GET https://api.dataforseo.com/v3/app_data/google/languages

5 Specify the number of apps to be returned in the API response. To do so, add the depth parameter and set it to the desired value.

We strongly recommend setting the parsing depth in the multiples of 100 as our system processes 100 results in a row. Thus, if you specify depth as 101 you will be charged for 200 results.

Default depth value: 100.

Maximum depth value: 200.

6 You can get more specific results by specifying the app category in the app_category field. For example, if you include "app_category": "family" to your POST request, the API will return only the apps from the family category on Google Play.

You will receive the full list of available categories by making a separate request to the Categories endpoint.

GET https://api.dataforseo.com/v3/app_data/google/categories

7 You can also filter apps by age rating with the age_rating parameter. Possible values:

ages_up_to_5 — return apps approved for children up to 5 years old;
ages_6_8 — return apps approved for children from 6 to 8 years old;
ages_9_12 — return apps approved for children from 9 to 12 years old.

By default, the API returns apps for all ages.

Note: this filter works only in conjunction with the "category": "family" parameter.

Your POST request should be structured as in the following example:

[
    {
        "app_collection": "top_free",
        "location_code": 2840,
        "language_code": "en",
        "app_category": "shopping"
    }
]

8 Send your request and use the Task ID from the response to retrieve the results from the Google App List Task GET Advanced endpoint.

GET https://api.dataforseo.com/v3/app_data/google/app_list/task_get/advanced/$id

Example of the API response:

{
  "version": "0.1.20220428",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.0744 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "05161047-2806-0422-0000-0cee40021246",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0262 sec.",
      "cost": 0,
      "result_count": 1,
      "path": [
        "v3",
        "app_data",
        "google",
        "app_list",
        "task_get",
        "advanced",
        "05161047-2806-0422-0000-0cee40021246"
      ],
      "data": {
        "se_type": "app_list",
        "se": "google",
        "api": "app_data",
        "function": "app_list",
        "app_collection": "top_free",
        "location_code": 2840,
        "language_code": "en",
        "app_category": "shopping",
        "device": "desktop",
        "os": "windows"
      },
      "result": [
        {
          "keyword": "top_free",
          "se_domain": "play.google.com",
          "location_code": 2840,
          "language_code": "en",
          "check_url": "https://play.google.com/store/apps/collection/cluster?clp=0g4gCh4KGHRvcHNlbGxpbmdfZnJlZV9TSE9QUElORxAHGAM%3D:S:ANO1ljIm-qs&gsr=CiPSDiAKHgoYdG9wc2VsbGluZ19mcmVlX1NIT1BQSU5HEAcYAw%3D%3D:S:ANO1ljIc-1Q&hl=en&gl=us",
          "datetime": "2022-05-16 07:47:31 +00:00",
          "se_results_count": 0,
          "items_count": 100,
          "items": [
            {
              "type": "google_play_search_organic",
              "rank_group": 1,
              "rank_absolute": 1,
              "position": "left",
              "app_id": "com.zzkko",
              "title": "SHEIN-Fashion Shopping Online",
              "url": "https://play.google.com/store/apps/details?id=com.zzkko",
              "icon": "https://play-lh.googleusercontent.com/99kIOo2NkDRAwBGQRfcq8-RP9x4PRKSxXlhiK519nxKF5ikbKhXdtgUrRI3UaSPTSwo",
              "reviews_count": null,
              "rating": {
                "rating_type": "Max5",
                "value": 4.754008,
                "votes_count": null,
                "rating_max": 5
              },
              "is_free": true,
              "price": {
                "current": 0,
                "regular": null,
                "max_value": null,
                "currency": null,
                "is_price_range": false,
                "displayed_price": null
              },
              "developer": "Shein Group Ltd",
              "developer_url": "https://play.google.com/store/apps/developer?id=Shein+Group+Ltd"
            },
            {
              "type": "google_play_search_organic",
              "rank_group": 2,
              "rank_absolute": 2,
              "position": "left",
              "app_id": "com.alibaba.intl.android.apps.poseidon",
              "title": "Alibaba.com - B2B marketplace",
              "url": "https://play.google.com/store/apps/details?id=com.alibaba.intl.android.apps.poseidon",
              "icon": "https://play-lh.googleusercontent.com/D09AsmYSxDpMWRSXbu54j2R_8sR-1OgbV2DXSI9_HIuY2IMZ8b8JgscWol6mikknaks",
              "reviews_count": null,
              "rating": {
                "rating_type": "Max5",
                "value": 4.49799,
                "votes_count": null,
                "rating_max": 5
              },
              "is_free": true,
              "price": {
                "current": 0,
                "regular": null,
                "max_value": null,
                "currency": null,
                "is_price_range": false,
                "displayed_price": null
              },
              "developer": "Alibaba Mobile",
              "developer_url": "https://play.google.com/store/apps/developer?id=Alibaba+Mobile"
            },
            {
              "type": "google_play_search_organic",
              "rank_group": 3,
              "rank_absolute": 3,
              "position": "left",
              "app_id": "com.amazon.mShop.android.shopping",
              "title": "Amazon Shopping",
              "url": "https://play.google.com/store/apps/details?id=com.amazon.mShop.android.shopping",
              "icon": "https://play-lh.googleusercontent.com/QPKtPRTJyhrYoPqYmjP81aCeYAQrH7ocIC25Tw8spEoKsX7eY0cqXMJp4QfkIq2bSg",
              "reviews_count": null,
              "rating": {
                "rating_type": "Max5",
                "value": 4.6501307,
                "votes_count": null,
                "rating_max": 5
              },
              "is_free": true,
              "price": {
                "current": 0,
                "regular": null,
                "max_value": null,
                "currency": null,
                "is_price_range": false,
                "displayed_price": null
              },
              "developer": "Amazon Mobile LLC",
              "developer_url": "https://play.google.com/store/apps/developer?id=Amazon+Mobile+LLC"
            },
            {
              "type": "google_play_search_organic",
              "rank_group": 4,
              "rank_absolute": 4,
              "position": "left",
              "app_id": "com.walmart.android",
              "title": "Walmart Shopping & Grocery",
              "url": "https://play.google.com/store/apps/details?id=com.walmart.android",
              "icon": "https://play-lh.googleusercontent.com/nckECUuaqv8rJllZ3CIvOJxxBnqe0TISPy_X-9B3U8nM4rst1Nr0eixKZlXW5fKyiTsf",
              "reviews_count": null,
              "rating": {
                "rating_type": "Max5",
                "value": 4.6736064,
                "votes_count": null,
                "rating_max": 5
              },
              "is_free": true,
              "price": {
                "current": 0,
                "regular": null,
                "max_value": null,
                "currency": null,
                "is_price_range": false,
                "displayed_price": null
              },
              "developer": "Walmart",
              "developer_url": "https://play.google.com/store/apps/developer?id=Walmart"
            },
            {
              "type": "google_play_search_organic",
              "rank_group": 5,
              "rank_absolute": 5,
              "position": "left",
              "app_id": "com.myklarnamobile",
              "title": "Klarna | Shop now. Pay later.",
              "url": "https://play.google.com/store/apps/details?id=com.myklarnamobile",
              "icon": "https://play-lh.googleusercontent.com/tDXSaAt_I_qx6am_rTcQ1WHaXo6ncfiB-b742DnSXZkJGASvs15yRYnvzogzbYwse0QD",
              "reviews_count": null,
              "rating": {
                "rating_type": "Max5",
                "value": 4.659578,
                "votes_count": null,
                "rating_max": 5
              },
              "is_free": true,
              "price": {
                "current": 0,
                "regular": null,
                "max_value": null,
                "currency": null,
                "is_price_range": false,
                "displayed_price": null
              },
              "developer": "Klarna Bank AB (publ)",
              "developer_url": "https://play.google.com/store/apps/developer?id=Klarna+Bank+AB+(publ)"
            }
          ]
        }
      ]
    }
  ]
}

Receiving apps from App Store collections

1 Call the Apple App List Task POST endpoint.

POST https://api.dataforseo.com/v3/app_data/apple/app_list/task_post

2 Specify the app collection from which you wish to collect applications in the app_collection field.

Possible values: top_free_ios, top_paid_ios, top_grossing_ios, new_ios, new_free_ios, new_paid_ios

3 Specify the location parameters by adding the location_name or location_code field to the POST body.

You will receive the full list of available locations by making a separate request to the Locations endpoint.

GET https://api.dataforseo.com/v3/app_data/apple/locations

4 Specify the language parameters by adding the language_name or language_code field to the POST body.

You will receive the full list of available languages by making a separate request to the Languages endpoint.

GET https://api.dataforseo.com/v3/app_data/apple/languages

5 Specify the number of apps to be returned in the API response. To do so, add the depth parameter and set it to the desired value.

We strongly recommend setting the parsing depth in the multiples of 100 as our system processes 100 results in a row. Thus, if you specify depth as 101 you will be charged for 200 results.

Default depth value: 100.

Maximum depth value: 1000.

6 You can get more specific results by specifying the app category in the app_category field. For example, if you include "app_category": "lifestyle" to your POST request, the API will return only the apps from the lifestyle category on App Store.

You will receive the full list of available categories by making a separate request to the Categories endpoint.

GET https://api.dataforseo.com/v3/app_data/apple/categories

Your POST request should be structured as in the following example:

[
    {
        "app_collection": "top_free_ios",
        "location_code": 2840,
        "language_code": "en",
        "app_category": "games"
    }
]

7 Send your request and use the Task ID from the response to retrieve the results from the Apple App List Task GET Advanced endpoint.

GET https://api.dataforseo.com/v3/app_data/apple/app_list/task_get/advanced/$id

Example of the API response:

{
  "version": "0.1.20220428",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.0804 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "05161051-2806-0422-0000-8ad2c836119d",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0320 sec.",
      "cost": 0,
      "result_count": 1,
      "path": [
        "v3",
        "app_data",
        "apple",
        "app_list",
        "task_get",
        "advanced",
        "05161051-2806-0422-0000-8ad2c836119d"
      ],
      "data": {
        "se_type": "app_list",
        "se": "apple",
        "api": "app_data",
        "function": "app_list",
        "app_collection": "top_free_ios",
        "location_code": 2840,
        "language_code": "en",
        "app_category": "games",
        "device": "desktop",
        "os": "windows"
      },
      "result": [
        {
          "keyword": "top_free_ios",
          "se_domain": "itunes.apple.com",
          "location_code": 2840,
          "language_code": "en",
          "check_url": null,
          "datetime": "2022-05-16 07:51:57 +00:00",
          "se_results_count": 100,
          "items_count": 100,
          "items": [
            {
              "type": "app_store_search_organic",
              "rank_group": 1,
              "rank_absolute": 1,
              "position": "left",
              "app_id": "512939461",
              "title": "Subway Surfers",
              "url": "https://apps.apple.com/us/app/subway-surfers/id512939461",
              "icon": "https://is2-ssl.mzstatic.com/image/thumb/Purple112/v4/a0/8b/60/a08b606d-7a3c-20d6-0e38-c277aac1ccc5/AppIcon-0-0-1x_U007emarketing-0-0-0-7-0-0-sRGB-0-0-0-GLES2_U002c0-512MB-85-220-0-0.png/512x512bb.jpg",
              "reviews_count": 1778750,
              "rating": {
                "rating_type": "Max5",
                "value": 4.63703,
                "votes_count": 1778750,
                "rating_max": 5
              },
              "is_free": true,
              "price": {
                "current": 0,
                "regular": null,
                "max_value": null,
                "currency": "USD",
                "is_price_range": false,
                "displayed_price": null
              }
            },
            {
              "type": "app_store_search_organic",
              "rank_group": 2,
              "rank_absolute": 2,
              "position": "left",
              "app_id": "1590319959",
              "title": "Dislyte",
              "url": "https://apps.apple.com/us/app/dislyte/id1590319959",
              "icon": "https://is4-ssl.mzstatic.com/image/thumb/Purple126/v4/5b/59/b6/5b59b610-4e4a-2e36-068d-9eb6160bb89c/AppIcon-0-0-1x_U007emarketing-0-0-0-7-0-0-sRGB-0-0-0-GLES2_U002c0-512MB-85-220-0-0.png/512x512bb.jpg",
              "reviews_count": 30794,
              "rating": {
                "rating_type": "Max5",
                "value": 4.66036,
                "votes_count": 30794,
                "rating_max": 5
              },
              "is_free": true,
              "price": {
                "current": 0,
                "regular": null,
                "max_value": null,
                "currency": "USD",
                "is_price_range": false,
                "displayed_price": null
              }
            },
            {
              "type": "app_store_search_organic",
              "rank_group": 3,
              "rank_absolute": 3,
              "position": "left",
              "app_id": "1595199218",
              "title": "Deliver It 3D",
              "url": "https://apps.apple.com/us/app/deliver-it-3d/id1595199218",
              "icon": "https://is2-ssl.mzstatic.com/image/thumb/Purple122/v4/41/4b/81/414b815d-266d-a00f-0eb2-c472f3d717e4/AppIcon-0-0-1x_U007emarketing-0-0-0-7-0-0-sRGB-0-0-0-GLES2_U002c0-512MB-85-220-0-0.png/512x512bb.jpg",
              "reviews_count": 14274,
              "rating": {
                "rating_type": "Max5",
                "value": 4.66134,
                "votes_count": 14274,
                "rating_max": 5
              },
              "is_free": true,
              "price": {
                "current": 0,
                "regular": null,
                "max_value": null,
                "currency": "USD",
                "is_price_range": false,
                "displayed_price": null
              }
            },
            {
              "type": "app_store_search_organic",
              "rank_group": 4,
              "rank_absolute": 4,
              "position": "left",
              "app_id": "664575829",
              "title": "Fishdom",
              "url": "https://apps.apple.com/us/app/fishdom/id664575829",
              "icon": "https://is5-ssl.mzstatic.com/image/thumb/Purple116/v4/5d/36/78/5d367815-f1e9-cbd0-d085-839895ccf3f9/AppIcon-1x_U007emarketing-0-6-0-85-220.png/512x512bb.jpg",
              "reviews_count": 688967,
              "rating": {
                "rating_type": "Max5",
                "value": 4.63602,
                "votes_count": 688967,
                "rating_max": 5
              },
              "is_free": true,
              "price": {
                "current": 0,
                "regular": null,
                "max_value": null,
                "currency": "USD",
                "is_price_range": false,
                "displayed_price": null
              }
            },
            {
              "type": "app_store_search_organic",
              "rank_group": 5,
              "rank_absolute": 5,
              "position": "left",
              "app_id": "1610991235",
              "title": "Perfect Coffee 3D",
              "url": "https://apps.apple.com/us/app/perfect-coffee-3d/id1610991235",
              "icon": "https://is5-ssl.mzstatic.com/image/thumb/Purple122/v4/9b/9d/29/9b9d2981-235e-d634-a3ec-1aad19aac769/AppIcon-0-0-1x_U007emarketing-0-0-0-7-0-0-sRGB-0-0-0-GLES2_U002c0-512MB-85-220-0-0.png/512x512bb.jpg",
              "reviews_count": 1452,
              "rating": {
                "rating_type": "Max5",
                "value": 4.64187,
                "votes_count": 1452,
                "rating_max": 5
              },
              "is_free": true,
              "price": {
                "current": 0,
                "regular": null,
                "max_value": null,
                "currency": "USD",
                "is_price_range": false,
                "displayed_price": null
              }
            }
          ]
        }
      ]
    }
  ]
}

Embed DataForSeo widget on your website


Embed code:
Preview: