ข้อมูลโซเชียล (เบต้า)

GET /v1/social/{platform}/{capability} คืนข้อมูลสาธารณะจาก Douyin, Xiaohongshu, TikTok, YouTube และแพลตฟอร์มโซเชียลอื่น ๆ โดยใช้คีย์ API และยอดเงินเดียวกับการเรียกโมเดล แต่ละแพลตฟอร์มและแต่ละความสามารถคิดราคาต่อการเรียกที่สำเร็จหนึ่งครั้ง และ data คือการตอบกลับดั้งเดิมของแพลตฟอร์ม — ฟิลด์ไม่ได้ถูกปรับให้เป็นรูปแบบเดียวกันระหว่างแพลตฟอร์ม

GET /v1/social/{platform}/{capability}
curl --get "https://api.chinaapi.ai/v1/social/tiktok/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=TikTok'

# HTTP 200
# {"object": "social.result", "platform": "tiktok", "capability": "search", "data": {...}}
เบต้า: เฉพาะบัญชีที่ชำระเงินแล้ว เติมเงินครั้งแรกให้เสร็จก่อนเรียกใช้ เครดิตทดลองใช้กับเอนด์พอยต์เหล่านี้ไม่ได้ บัญชีที่ไม่เคยเติมเงินจะได้รับ HTTP 403 model_requires_topup เวอร์ชันเบต้าไม่มี SLA และแพลตฟอร์ม เอนด์พอยต์ และราคาอาจเปลี่ยนแปลงได้

การยืนยันตัวตนและการคิดเงิน

ส่งคีย์ ChinaAPI ของคุณเป็น bearer token ไปที่ https://api.chinaapi.ai เหมือนการเรียกโมเดลทั่วไป การเรียกหนึ่งครั้งจะถูกคิดเงินครั้งเดียวตามราคาที่ระบุไว้ของเอนด์พอยต์นั้น และเฉพาะเมื่อคืน HTTP 200 พร้อมข้อมูลเท่านั้น ผลลัพธ์ว่าง พารามิเตอร์ที่ถูกปฏิเสธ หรือต้นทางล้มเหลว จะไม่มีค่าใช้จ่าย การดึงแต่ละหน้าคือการเรียกแยกกัน บันทึกการใช้งานจะแสดงแต่ละการเรียกภายใต้ชื่อที่แสดงคู่กับเอนด์พอยต์ เช่น social-douyin-search

การตอบกลับและข้อผิดพลาด

การตอบกลับที่สำเร็จจะห่อข้อมูลของแพลตฟอร์มไว้ในซองข้อมูลขนาดเล็ก ทุกอย่างภายใน data — ชื่อฟิลด์ เคอร์เซอร์แบ่งหน้า และ ID — เป็นของแพลตฟอร์มเอง ให้ส่งเคอร์เซอร์กลับไปตามที่ได้รับมาทุกประการ

{
  "object": "social.result",
  "platform": "douyin",
  "capability": "search",
  "data": { "...": "the platform's own fields" }
}
  • 400 — พารามิเตอร์ไม่รู้จัก ซ้ำ ยาวเกินไป ผิดชนิด หรือขาดหายไป รวมถึงกรณีที่ไม่ได้ระบุสมาชิกใดเลยของกลุ่ม "อย่างน้อยหนึ่งรายการจาก" ฟิลด์ code ของข้อผิดพลาดจะบอกว่าเป็นกรณีใด เช่น unknown_parameter หรือ missing_parameter
  • 403 model_requires_topup — บัญชียังไม่ได้เติมเงินครั้งแรก
  • 404 — ไม่มีคู่แพลตฟอร์มและความสามารถนี้ หรือแพลตฟอร์มไม่พบข้อมูลใดสำหรับพารามิเตอร์เหล่านี้ (social_data_no_result)
  • 429 social_data_capacity_reached — ความจุรายวันของเบต้าถูกใช้หมดแล้วและจะรีเซ็ตเวลา 00:00 UTC หรือแพลตฟอร์มกำลังยุ่ง ซึ่งลองใหม่อีกไม่กี่วินาทีก็จะผ่าน อย่าลองซ้ำถี่ ๆ ในลูป
  • 502 — แหล่งข้อมูลไม่ตอบกลับ หรือตอบกลับโดยไม่มีข้อมูล
  • 503 social_data_unavailable — เอนด์พอยต์นี้ถูกหยุดชั่วคราวอยู่ในขณะนี้ แคตตาล็อกสดจะแสดงสถานะเป็น paused

การตอบกลับเหล่านี้ไม่มีรายการใดถูกคิดเงิน

การใช้งานที่ยอมรับได้

ปฏิบัติตามข้อกำหนดของแต่ละแพลตฟอร์มและกฎการคุ้มครองข้อมูลที่ใช้กับคุณ ห้ามใช้ API นี้สร้างโปรไฟล์ของบุคคล การเข้าสู่ระบบ การดึงข้อมูลติดต่อ การปั่นยอดการมีส่วนร่วม และการเข้าถึงเนื้อหาส่วนตัวหรือเนื้อหาแบบเสียเงิน อยู่นอกขอบเขตของเบต้านี้

แพลตฟอร์มและราคา

USD ต่อการเรียกที่สำเร็จหนึ่งครั้ง แต่ละราคาลิงก์ไปยังเอนด์พอยต์ด้านล่าง และขีดหมายความว่าแพลตฟอร์มนั้นไม่มีความสามารถดังกล่าว แคตตาล็อกสด — GET https://dash.chinaapi.ai/api/social/catalog ไม่ต้องใช้คีย์ — คือแหล่งอ้างอิงหลักว่าตอนนี้มีอะไรขายอยู่ รวมถึงเอนด์พอยต์ที่หยุดชั่วคราว

เอนด์พอยต์

ใส่พารามิเตอร์ใน query string ด้วยชื่อของแพลตฟอร์มเอง ตัวอย่างมาจากแคตตาล็อก ให้แทนที่ตัวระบุด้วยเนื้อหาที่คุณต้องการดึง