Pipispy API中文

Data usage rules: 1. Obtaining a data result consumes 1 data. Obtaining more detailed information about a data result does not consume data. 2. Ad Tracker: Each monitoring session costs $1/month. Each monitoring session is valid for one month and automatically expires after one month. Deleting a monitoring session does not restore the monitoring session, so please delete with caution. Monitoring sessions can be accessed at any time and are unlimited.

App Detail API

API Information

  • API Name: Get App Detail
  • Request Method: POST
  • API URL: /open-api/v1/data
  • Interface URI path: /v3/api/open/app/detail
  • Description: Get detailed information of app by app ID
  • Pricing: Details API pricing rules: Base fee: 1 credit/request. Free access conditions (if either is met): Details for this ID have been retrieved within the past 3 days; This ID appeared in your leaderboard list query results within the past 3 days.

Request Headers:

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

Request Parameters

Request Structure

Parameter Name Type Description Example Required Default
key string User's external API request key "your_api_key_here" Yes
uri string Interface URI path "/v3/api/open/app/detail" Yes
params object Interface parameter object See parameter list below Yes

Parameter List (params object)

Parameter Name Type Description Example Required Default
id string App ID "61d787d667dcc8ca6a82" Yes

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/detail",
    "params": {
      "id": "61d787d667dcc8ca6a82"
    }
  }'

Response Parameters

Response Body Structure

{
  "code": 200,
  "message": "success",
  "data": {
    // App detail information
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 1,
  "success": true,
  "fail": false
}

Response Field Description

Main Response Fields
Field Name Type Description
id string App ID
name string App name
icon string App icon URL
rate object Rating information
url string App store link
app_download_count number App download count
app_comment_count number App comment count
desc string App description
app_system string App system (ios/android)
app_store string App store (apple/google)
app_type string App type (app/game)
app_category object App category information
app_create_time number App creation time (timestamp)
app_update_time number App update time (timestamp)
ad_platform_list array Ad platform list
app_dev object Developer information
is_collection boolean Is collected
revenue object Revenue information
last_month_app_download_count number Last month download count
images array App screenshot list
all_data_count number Total data count
top_region array Top regions
top_in_app_purchases array In-app purchase information
keywords array Keyword list
Rate Object Fields
Field Name Type Description
score number Rating score
count number Rating count
rate1 number 1-star rating count
rate2 number 2-star rating count
rate3 number 3-star rating count
rate4 number 4-star rating count
rate5 number 5-star rating count
App Category Object Fields
Field Name Type Description
id string Category ID
name string Category name
type string Category type
app_system string App system
app_store string App store
children array Sub-category list
App Developer Object Fields
Field Name Type Description
id string Developer ID
name string Developer name
email string Developer email
url string Developer URL
icon string Developer icon URL
avatar string Developer avatar URL
website_url string Developer website URL (optional)
Revenue Object Fields
Field Name Type Description
unit string Revenue unit (cent)
currency string Currency type (USD, etc.)
type string Revenue type (currency)
value number Revenue value (in cents)
In-App Purchase Object Fields
Field Name Type Description
price string Price range description
Keyword Object Fields
Field Name Type Description
name string Keyword name
url string Keyword search URL
Root Level Response Fields
Field Name Type Description
code number Response status code
message string Response message
data object App detail data
version string API version
timestamp number/null Timestamp
sign string/null Signature
remaining_credits Long Current remaining available credits after this request
consumed_credits Long Credits consumed by this request
success boolean Request success status
fail boolean Request failure status

Response Example

{
  "code": 200,
  "message": "success",
  "data": {
    "id": "69474be0ed2cecb479b1",
    "name": "Stickman vs Monster: Idle RPG",
    "icon": "https://cdn-app.pipispy.com/86f80c31e7712aa1ff486b1ff210028b.jpg",
    "rate": {
      "score": 4.8965516,
      "count": 12565,
      "rate1": 216,
      "rate2": 0,
      "rate3": 0,
      "rate4": 433,
      "rate5": 11916
    },
    "url": "https://play.google.com/store/apps/details?id=com.stickman.monster.epic.stickman.war.shadow.idle.game",
    "app_download_count": 1528081,
    "app_comment_count": 12566,
    "desc": "<b>Idle Gameplay, Epic Rewards</b><br>Stickman vs Monster offers a relaxed and enjoyable gaming experience...",
    "app_system": "android",
    "app_store": "google",
    "app_type": "game",
    "app_category": {
      "id": "googlegame",
      "name": "Game",
      "type": "game",
      "children": [
        {
          "id": "GAME_ROLE_PLAYING",
          "name": "Role Playing",
          "type": "game",
          "app_system": "android"
        }
      ],
      "app_system": "android"
    },
    "app_create_time": 1736218411,
    "app_update_time": 1750895087,
    "ad_platform_list": ["tiktok"],
    "app_dev": {
      "id": "7752608683054605616",
      "name": "Fansipan Limited",
      "email": "[email protected]",
      "url": "https://play.google.com/store/apps/dev?id=7752608683054605616",
      "icon": "https://cdn-app.pipispy.com/c8bb0c844b7fe66799bed62b7da8a166.jpg",
      "avatar": "https://cdn-app.pipispy.com/c8bb0c844b7fe66799bed62b7da8a166.jpg"
    },
    "is_collection": false,
    "revenue": {
      "unit": "cent",
      "currency": "USD",
      "type": "currency",
      "value": 2000000
    },
    "last_month_app_download_count": 200000,
    "images": [
      "https://cdn-app.pipispy.com/c37bd0ad1bb037fd89f174846d2b434f.jpg",
      "https://cdn-app.pipispy.com/59ba6218aa9ac9c8de05aef730d0f9d9.jpg",
      "https://cdn-app.pipispy.com/f71de19f71464fa8a2070f37362ac812.jpg"
    ],
    "all_data_count": 937,
    "top_region": ["US", "VN", "TW"],
    "top_in_app_purchases": [
      {
        "price": "$1.49 - $99.99 per item"
      }
    ],
    "keywords": [
      {
        "name": "Idle RPG",
        "url": "/store/search?q=Idle+RPG+games&c=apps"
      },
      {
        "name": "Stylized",
        "url": "/store/search?q=Stylized+games&c=apps"
      },
      {
        "name": "Monster",
        "url": "/store/search?q=Monster+games&c=apps"
      },
      {
        "name": "Stickman",
        "url": "/store/search?q=Stickman+games&c=apps"
      }
    ]
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 1,
  "success": true,
  "fail": false
}

Error Code Description

Error Code Description
200 Success
400 Bad Request - Invalid parameters
401 Unauthorized - Invalid API key
404 Not Found - App not found
500 Internal Server Error