快速开始 - SocialVision Docs

1. 注册账号与获取 API Key

访问 SocialVision 控制台。
注册并登录进入控制台。
导航至 API Keys 页面，点击 创建新 Key。
复制生成的密钥（形如 sv_live_...），密钥明文仅展示一次，请妥善保存。

2. 额度充值 (Credits)

SocialVision 采用预充值积分制：

基准汇率：1.00 Credit = ¥1.00 人民币。
大部分端点售价：0.10 Credits / 次（即 ¥0.10 元一次）。
前往官方发卡网 shop.tosykan.xyz 购买额度卡密。
在控制台 Credits 页面输入卡密完成核销。

3. 发起第一次数据调用

网关统一调用地址为：POST https://socialvision.tisyk.xyz/api/v1/run

cURL

curl -X POST https://socialvision.tisyk.xyz/api/v1/run \
  -H "Authorization: Bearer sv_live_你的API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "tikhub",
    "endpoint": "/api/v1/xiaohongshu/app_v2/search_notes",
    "input": {
      "keyword": "咖啡探店",
      "page": 1,
      "sort_type": "general"
    }
  }'

Python

import requests

API_KEY = "sv_live_你的API_KEY"
url = "https://socialvision.tisyk.xyz/api/v1/run"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

payload = {
    "provider": "tikhub",
    "endpoint": "/api/v1/xiaohongshu/app_v2/search_notes",
    "input": {
        "keyword": "咖啡探店",
        "page": 1,
        "sort_type": "general"
    }
}

response = requests.post(url, headers=headers, json=payload)
data = response.json()
print("扣费结果:", data.get("billing"))
print("笔记列表:", data.get("output", {}).get("data", {}).get("items", []))