App 列表接口

接口信息

• 接口名称: 获取 App 列表
• 请求方法: POST
• 接口地址: /open-api/v1/data
• 接口路径: /v3/api/open/app/list
• 接口描述: 根据过滤条件获取 App 列表信息，支持分页
• 价格说明: 获取一条数据结果消耗1 credit

请求头:

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

请求参数

请求结构

参数列表 (params 对象)

请求示例

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
    }
  }'

响应参数

响应体结构

{
  "code": 200,
  "message": "success",
  "data": {
    "data": [
      // App列表项
    ],
    "page": {
      // 分页信息
    }
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 20,
  "success": true,
  "fail": false
}

响应字段说明

主要响应字段

数据对象字段 (data)

列表项字段

App 分类对象字段 (app_category)

子分类对象字段 (children)

App 评分对象字段 (app_rate)

上月收入对象字段 (last_month_revenue)

最新数据对象字段 (latest_data)

App 开发者信息对象字段 (app_dev_info)

分页信息字段 (page)

响应示例

{
  "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
}

错误码说明