Pipispy API中文

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