Xiaohongshu (RED) · ค้นหาโพสต์

เบต้า

ข้อมูลสาธารณะจากแพลตฟอร์มโซเชียล คิดเงินต่อการเรียก ใช้คีย์ API และยอดเงินเดียวกับการเรียกโมเดล

เฉพาะบัญชีที่เติมเงินครั้งแรกแล้ว ไม่มีทดลองใช้ฟรี · จะคิดเงินเฉพาะเมื่อการเรียกส่งกลับ HTTP 200 และ data ไม่ว่างเท่านั้น ผลลัพธ์ว่าง พารามิเตอร์ถูกปฏิเสธ หรือต้นทางล้มเหลวจะไม่คิดเงิน

พารามิเตอร์คำขอ

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

ชื่อ	ประเภท	จำเป็น	ตัวอย่าง	คำอธิบาย
`keyword`	string	ใช่	`"美食推荐"`	Search keyword
`page`	integer	ไม่	`1`	Page number, start from 1
`sort_type`	string	ไม่	`"general"`	Sort type
`note_type`	string	ไม่	`"不限"`	Note type: 不限 (all), 视频笔记 (video), 普通笔记 (standard), 直播笔记 (live). Send the literal Chinese value.
`time_filter`	string	ไม่	`"不限"`	Time filter: 不限 (all), 一天内 (one day), 一周内 (one week), 半年内 (half year). Send the literal Chinese value.
`search_id`	string	ไม่	`""`	Search ID for pagination
`search_session_id`	string	ไม่	`""`	Search session ID for pagination
`source`	string	ไม่	`"explore_feed"`	Source
`ai_mode`	integer	ไม่	`0`	AI mode: 0=off, 1=on

ตัวอย่างคำขอ

curl --get "https://api.chinaapi.ai/v1/social/xiaohongshu/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=美食推荐'

โครงสร้างการตอบกลับ

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

{
  "object": "social.result",
  "platform": "xiaohongshu",
  "capability": "search",
  "data": { … }
}

การแบ่งหน้า

พารามิเตอร์แบ่งหน้า: page, search_id, search_session_id แต่ละหน้าคือการเรียกที่คิดเงินแยกกัน ค่าเคอร์เซอร์ให้นำมาจากการตอบกลับครั้งก่อนตามที่ได้รับ

ข้อผิดพลาดและกรณีที่ไม่คิดเงิน

รหัสสถานะ	รหัสข้อผิดพลาด	ความหมาย
400	—	พารามิเตอร์ไม่รู้จัก ซ้ำ ยาวเกินไป ผิดชนิด หรือขาดหายไป รวมถึงกรณีที่ไม่ได้ระบุสมาชิกใดเลยของกลุ่ม "อย่างน้อยหนึ่งรายการจาก" ฟิลด์ `code` ของข้อผิดพลาดจะบอกว่าเป็นกรณีใด เช่น `unknown_parameter` หรือ `missing_parameter`
403	`model_requires_topup`	บัญชียังไม่ได้เติมเงินครั้งแรก
404	`social_data_no_result`	ไม่มีคู่แพลตฟอร์มและความสามารถนี้ หรือแพลตฟอร์มไม่พบข้อมูลใดสำหรับพารามิเตอร์เหล่านี้ (`social_data_no_result`)
429	`social_data_capacity_reached`	ความจุรายวันของเบต้าถูกใช้หมดแล้วและจะรีเซ็ตเวลา 00:00 UTC หรือแพลตฟอร์มกำลังยุ่ง ซึ่งลองใหม่อีกไม่กี่วินาทีก็จะผ่าน อย่าลองซ้ำถี่ ๆ ในลูป
502	`social_data_no_result`	แหล่งข้อมูลไม่ตอบกลับ หรือตอบกลับโดยไม่มีข้อมูล
503	`social_data_unavailable`	เอนด์พอยต์นี้ถูกหยุดชั่วคราวอยู่ในขณะนี้ แคตตาล็อกสดจะแสดงสถานะเป็น `paused`

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

ทุกการตอบกลับมีเฮดเดอร์ X-Oneapi-Request-Id แนบค่านี้มาเมื่อติดต่อฝ่ายสนับสนุน เราจะค้นหาการเรียกครั้งนั้นได้

เงื่อนไขของเบต้า

เติมเงินครั้งแรกให้เสร็จก่อนเรียกใช้ เครดิตทดลองใช้กับเอนด์พอยต์เหล่านี้ไม่ได้ บัญชีที่ไม่เคยเติมเงินจะได้รับ HTTP 403 model_requires_topup เวอร์ชันเบต้าไม่มี SLA และแพลตฟอร์ม เอนด์พอยต์ และราคาอาจเปลี่ยนแปลงได้

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