App List API

API Information

• API Name: Get Apps List
• Request Method: POST
• API URL: /open-api/v1/data
• API Path: /v3/api/open/app/list
• API Description: Get app list information based on filter conditions, supports pagination
• Pricing: Retrieving one data result consumes 1 credit

Request Headers:

• Content-Type: application/json
• Accept: application/json

Request Parameters

Request Structure

Parameter List (params object)

Request Example

curl -X POST "https://www.pipispy.com/open-api/v1/data" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "key": "your_api_key_here",
    "uri": "/v3/api/open/app/list",
    "params": {
      "current_page": 1,
      "page_size": 10,
      "plat_type": 1,
      "search_type": 1,
      "sort": 1,
      "sort_type": "desc",
      "time": 7,
      "keyword": "MercadoLibre",
      "app_type": "app",
      "app_system": "ios",
      "app_category": "id6003,id6023",
      "region": "BR,TW,MX",
      "app_rating_min": 4.0,
      "app_rating_max": 5.0,
      "app_download_count_min": 1000000,
      "app_download_count_max": 10000000
    }
  }'

Response Parameters

Response Body Structure

{
  "code": 200,
  "message": "success",
  "data": {
    "data": [
      // App list items
    ],
    "page": {
      // Pagination information
    }
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 20,
  "success": true,
  "fail": false
}

Response Field Description

Main Response Fields

Data Object Fields (data)

Data Item Fields

App Category Object Fields (app_category)

Sub-category Object Fields (children)

App Rate Object Fields (app_rate)

Last Month Revenue Object Fields (last_month_revenue)

Latest Data Object Fields (latest_data)

App Developer Info Object Fields (app_dev_info)

Page Object Fields (page)

Response Example

{
  "code": 200,
  "message": "success",
  "data": {
    "data": [
      {
        "platform": ["tiktok"],
        "id": "87f57e4b74b194d57356",
        "icon": "https://cdn-app.pipispy.com/28a87cbcf0d6e412064780e89b3f02da.jpg",
        "region": ["BR", "TW"],
        "app_name": "Mercado Libre: Compras Online",
        "app_category": {
          "children": [
            {
              "name": "Shopping",
              "app_system": "ios",
              "id": "id6024",
              "type": "app"
            },
            {
              "name": "Lifestyle",
              "app_system": "ios",
              "id": "id6012",
              "type": "app"
            }
          ],
          "name": "App",
          "app_system": "ios",
          "id": "id36",
          "type": "app"
        },
        "app_rate": {
          "score": 4.8,
          "count": 321513
        },
        "created_time": 1315540800,
        "app_system": "ios",
        "app_type": "app",
        "app_store": "apple",
        "app_download_count": 13000000,
        "app_comment_count": 321513,
        "play_count": 624429116,
        "video_count": 15331,
        "digg_count": 1897788,
        "put_day": 1044,
        "found_time": 1662073352,
        "latest_found_time": 1752204713,
        "is_collection": false,
        "last_month_revenue": {
          "unit": "cent",
          "currency": "USD",
          "type": "currency",
          "value": 100000
        },
        "latest_data": [
          {
            "platform": 1,
            "url": "https://cdn-video.pipispy.com/cover_645e142802a755d4cc01.jpg",
            "count": 8606,
            "video_id": "645e142802a755d4cc01"
          }
        ],
        "region": ["BR", "TW"],
        "app_dev_info": {
          "id": "463624855",
          "name": "MercadoLibre"
        },
        "last_month_app_download_count": 1000000,
        "popular_person_count": 0
      }
    ],
    "page": {
      "total_count": 10000,
      "page_count": 500,
      "current_page": 1,
      "page_size": 20,
      "is_next": true
    }
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 20,
  "success": true,
  "fail": false
}

Error Code Description