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.

Product Detail API

API Information

  • API Name: Get Product Detail
  • Request Method: POST
  • API URL: /open-api/v1/data
  • Interface URI path: /v3/api/open/ad-product/detail
  • Description: Query product detail data
  • 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/ad-product/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 Product ID "507f1f77bcf86cd799439011" 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/ad-product/detail",
    "params": {
      "id": "507f1f77bcf86cd799439011"
    }
  }'

Response

Response Body Structure

{
  "code": 200,
  "message": "success",
  "data": {
    // Product 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
data object Product detail information
version string API version number
timestamp number/null Response timestamp
sign string/null Signature information
remaining_credits number Current remaining available credits after this request
consumed_credits number Credits consumed by this request
success boolean Whether the request was successful
fail boolean Whether the request failed
Product Detail Fields (data)
Field Name Type Description
id string Product unique identifier ID
image string Product main image URL
image_list array Product image list URLs
title string Product title
desc string Product description
landing_page string Product landing page URL
root_path string Product root path (domain)
root_path_id string Product root path ID
tt_data_count number TikTok platform video count
video_list array Product related video ID list
category object Product category information
currency string Product price currency type
price number Product price
create_time number Product creation timestamp
region array Product target region list
tt_play_count number TikTok platform play count
tt_digg_count number TikTok platform digg count
tt_digg_play_rate number TikTok platform digg/play ratio
tt_share_count number TikTok platform share count
tt_comment_count number TikTok platform comment count
tt_found_time number TikTok platform first found timestamp
tt_latest_found_time number TikTok platform latest found timestamp
tt_put_days number TikTok platform put days
platform string Product platform identifier
is_collection boolean Whether already collected
usd_price number Product USD price
ad_platform_list array Ad platform list (e.g., tiktok, facebook)
facebook_data_count number Facebook platform data count
facebook_digg_count number Facebook platform digg count
facebook_found_time number Facebook platform first found timestamp
facebook_latest_found_time number Facebook platform latest found timestamp
facebook_put_days number Facebook platform put days
all_data_count number All platform data count
all_digg_count number All platform digg count
all_found_time number All platform first found timestamp
all_latest_found_time number All platform latest found timestamp
all_put_days number All platform put days
app_names array App name list
app_image string App icon URL
shopify_data array Export for shopify data
Product Category Information Object Fields (category)
Field Name Type Description
id string Category ID
name_en string Category English name
name_zh string Category Chinese name

Response Example

{
  "code": 200,
  "message": "success",
  "data": {
    "id": "686eb791ce41be1463bf6020",
    "image": "https://cdn-product.pipispy.com/pimg_f3f1ce1ad8e01bb942e0.png",
    "title": "NIACINAMIDE SERUM",
    "desc": "Heb je last van acne, puistjes of een vette huid? Onze krachtige formule helpt je huid weer in balans te brengen, ontstekingen, roodheid en irritatie te verminderen, bacteriën te doden en poriën te ontstoppen. Niacinamide serum staat bekend om zijn antivirale eigenschappen die de huid kunnen helpen beschermen tegen infecties. Het serum zit boordevol belangrijke ingrediënten die samenwerken om acne te verminderen en toekomstige puistjes te voorkomen.NIACINAMIDEVan Niacinamide is het wetenschappelijk bewezen dat het ontstekingen tegengaat. Dat betekent dat je minder last zal hebben van acne (puistjes). Een hoge concentratie van 10% van deze vitamine wordt in de formule ondersteund door het zinkzout van pyrrolidoncarbonzuur om de zichtbare aspecten van talgactiviteit in evenwicht te brengen.RETINOLRetinol is een katalysator voor de aanmaak van nieuwe cellen. Hierdoor merk je al snel dat de hoeveelheid lijntjes, plooien en rimpels in je gezicht verminderen. Ook gaat Retinol actief kleine oneffenheden tegen zoals pigment- en ouderdomsvlekken.VITAMINE CStaat bekend om zijn krachtige anti-oxiderende werking. Daarnaast verhoogt het de productie van Collageen, wat beschadigde huid repareert en je gezicht weer voller en elastischer maakt.HYALURONZUURJe huid heeft vocht nodig om er gezond en fris uit te zien. Een goed gehydrateerde huid heeft minder rimpeltjes en fijne lijntjes, maar ook wallen en kringen onder je ogen kunnen er zichtbaar minder door worden. De moleculen van Hyaluronzuur houden vocht ontzettend goed vast. Dit verzacht je huid van binnen, en maakt je gezicht in no-time merkbaar steviger.VITAMINE EIs een anti-oxidant, welke de negatieve invloed van vrije radicalen tegengaat. Het geeft een boost aan het immuunsysteem, repareert huidschade die veroorzaakt wordt door UV-straling, en heeft ook nog een anti-ontstekende werking.",
    "category": {
      "id": "62739ba438365b2f72048ec9",
      "name_en": "Beauty&Health",
      "name_zh": "美容与健康"
    },
    "currency": "EUR",
    "price": 15.95,
    "region": [],
    "platform": "shopify",
    "image_list": [
      "https://cdn-product.pipispy.com/pimg_f3f1ce1ad8e01bb942e0.png",
      "https://cdn-product.pipispy.com/pimg_793ee21c316a2278f533.png",
      "https://cdn-product.pipispy.com/pimg_c3f7bae1270348da3c70.png",
      "https://cdn-product.pipispy.com/pimg_404ae6efb292f56dc52b.png",
      "https://cdn-product.pipispy.com/pimg_c95d7a771e44f957aab0.png"
    ],
    "landing_page": "https://skintoneskin.com/products/niacinamide-serum?utm_content=Facebook_UA&utm_source=facebook&variant=47386041647448&utm_medium=paid&utm_id=120223082604420224&utm_term=120226427318530224&utm_campaign=120223082604420224",
    "root_path": "skintoneskin.com",
    "root_path_id": "665dab26392bf2e615d1b34a",
    "tt_data_count": 0,
    "video_list": [],
    "create_time": 1698334660,
    "tt_play_count": 0,
    "tt_digg_count": 0,
    "tt_digg_play_rate": 0.0,
    "tt_share_count": 0,
    "tt_comment_count": 0,
    "is_collection": false,
    "usd_price": 18.7,
    "ad_platform_list": ["facebook"],
    "facebook_data_count": 1,
    "facebook_digg_count": 7,
    "facebook_found_time": 1752086417,
    "facebook_latest_found_time": 1752201956,
    "facebook_put_days": 2,
    "all_data_count": 1,
    "all_digg_count": 7,
    "all_found_time": 1752086417,
    "all_latest_found_time": 1752201956,
    "all_put_days": 2,
    "app_names": ["SKINTONE SKIN"],
    "app_image": "https://fb-cdn.pipispy.com/images/168bf4be00376b24595549f1b0f0afaa.png"
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 1,
  "success": true,
  "fail": false
}

Error Codes

Error Code Description
400 Bad Request - Invalid parameters
401 Unauthorized - Invalid API key
500 Internal Server Error