Twitter API

API Twitter: ค้นหาผู้ใช้ ไทม์ไลน์ และการแบ่งหน้า

เชื่อมต่อเอนด์พอยต์ Twitter / X ของ API Hop ด้วยการยืนยันตัวตน Bearer การเลือกฟิลด์ผู้ใช้และทวีต การแบ่งหน้าแบบเคอร์เซอร์ และการจัดการข้อผิดพลาดการตรวจสอบค่า

ค้นหา ID ผู้ใช้จากชื่อผู้ใช้ ดึงไทม์ไลน์ของผู้ใช้นั้น แล้วส่งโทเคนถัดไปที่ได้รับเพื่อขออีกหน้า การเรียกสำเร็จส่ง JSON กลับโดยตรง เอนด์พอยต์เหล่านี้ไม่มีขั้นตอนโพล Jobs

รับคีย์ API สำรวจแค็ตตาล็อก API

ออกแบบสำหรับงานเฉพาะ

พัฒนาการดำเนินการ GET ทั้งสามที่รองรับและจัดการผลลัพธ์

ค้นหาบัญชีด้วยชื่อผู้ใช้และเลือกฟิลด์โปรไฟล์ที่จะส่งกลับ

รีเฟรชบัญชีที่ทราบแล้วด้วย ID ผู้ใช้โดยไม่ต้องค้นหาชื่ออีกครั้ง

ดึงหน้าไทม์ไลน์ด้วยขีดจำกัดขนาดหน้าและโทเคนแบ่งหน้า

หน่วยคิดค่าบริการ

เข้าใจวิธีวัดการใช้งาน

USD ต่อคำขอ

ข้อจำกัดการดำเนินงาน

ฟิลด์ที่ส่งกลับขึ้นอยู่กับพารามิเตอร์การค้นหาในเอกสารและการตอบกลับต้นทาง
max_results ต้องเป็นจำนวนเต็มตั้งแต่ 1 ถึง 100 หนึ่งหน้าอาจมีผลลัพธ์น้อยกว่านั้น
เก็บ ID ผู้ใช้และ ID ทวีตเป็นสตริงเพื่อหลีกเลี่ยงการสูญเสียความแม่นยำของตัวเลข

คู่มือการเชื่อมต่อ

เลือกขั้นตอนถัดไป

วางแผนรีเฟรชและจัดเก็บ จำกัดจำนวนคำขอ ตัดโพสต์ซ้ำ และบันทึกเวลาดึงข้อมูลในแอปของคุณ แค็ตตาล็อก API ข้อมูล ตรวจสอบผลิตภัณฑ์ข้อมูล การดำเนินการ และราคาต่อคำขอปัจจุบัน

ขอบเขตแค็ตตาล็อกปัจจุบัน

API ที่พร้อมใช้งานและหน่วยคิดค่าบริการ

เปรียบเทียบ ID API การดำเนินการ ผู้ให้บริการ และราคา ตรวจสอบวันที่แค็ตตาล็อกและหน่วยคิดค่าบริการของแต่ละการดำเนินการก่อนประมาณค่าใช้จ่าย

API ข้อมูล

Twitter User Data

twitter-user-data เอกสาร

ใช้งานอยู่

ดึงโปรไฟล์สาธารณะและไทม์ไลน์ผู้ใช้ Twitter / X

ผู้ให้บริการ: Twitter / X Data
หน่วยคิดค่าบริการ: คำขอ
รูปแบบและเอนด์พอยต์ API: ดูเอนด์พอยต์คำขอได้ในการดำเนินการด้านล่าง
ความสามารถที่เผยแพร่: ค้นหาผู้ใช้, ไทม์ไลน์ผู้ใช้

การดำเนินการที่เผยแพร่

GET /v1/twitter/users ดึงผู้ใช้ตามชื่อผู้ใช้
GET /v1/twitter/users/{id} ดึงผู้ใช้ตาม ID
GET /v1/twitter/users/{id}/tweets ดึงโพสต์ของผู้ใช้

ราคา API Hop

คำขอ: $0.0020 /คำขอ

ดึงผู้ใช้ตามชื่อผู้ใช้

GET /v1/twitter/users

ราคา API Hop

คำขอ: $0.0020 /คำขอ

ดึงผู้ใช้ตาม ID

GET /v1/twitter/users/{id}

ราคา API Hop

คำขอ: $0.0020 /คำขอ

ดึงโพสต์ของผู้ใช้

GET /v1/twitter/users/{id}/tweets

ราคา API Hop

คำขอ: $0.0020 /คำขอ

เปิดแค็ตตาล็อก API ทั้งหมด

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

เริ่มจากการดำเนินการในเอกสาร

curl "https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics" \
  -H "Authorization: Bearer <API_KEY>"

const response = await fetch("https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics", {
  headers: { Authorization: "Bearer <API_KEY>" }
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics"
headers = {"Authorization": "Bearer <API_KEY>"}
response = requests.get(url, headers=headers, timeout=60)
response.raise_for_status()
print(response.json())

ใช้ URL หลักของ API จากเอกสารบัญชีและแทนที่ตัวยึดตำแหน่งในตัวอย่าง ส่งคีย์ API ในส่วนหัว Authorization ห้ามใส่ใน URL หรือไฟล์ที่คอมมิต

เอนด์พอยต์

สามการดำเนินการสำหรับบัญชีและไทม์ไลน์

ค้นหาตามชื่อผู้ใช้ GET /v1/twitter/users?username=<USERNAME>

อ่าน data.id ที่ส่งกลับเป็นสตริงสำหรับคำขอถัดไป

ค้นหาตาม ID ผู้ใช้ GET /v1/twitter/users/<USER_ID>

ดึงบัญชีที่ทราบแล้วและเลือกฟิลด์โปรไฟล์ได้ตามต้องการ

ไทม์ไลน์ผู้ใช้ GET /v1/twitter/users/<USER_ID>/tweets

ตั้ง max_results และส่ง pagination_token สำหรับหน้าถัดไป

พารามิเตอร์การค้นหา

เลือกฟิลด์และแบ่งหน้าไทม์ไลน์

ค้นหาบัญชี: ต้องระบุ username บน /v1/twitter/users เอนด์พอยต์ค้นหาทั้งสองรับรายการ user.fields ที่คั่นด้วยจุลภาค เช่น description,public_metrics
ขนาดหน้า: max_results รับจำนวนเต็มตั้งแต่ 1 ถึง 100 เป็นขีดจำกัดบนของขนาดหน้า ไม่รับประกันว่าจะได้โพสต์จำนวนเท่านั้น
ฟิลด์ไทม์ไลน์: ใช้ tweet.fields=created_at,public_metrics สำหรับเวลาและตัวชี้วัด ขอ expansions=author_id พร้อม user.fields เมื่อต้องการรายละเอียดผู้เขียนที่มี ใช้ exclude=replies,retweets เพื่อตัดประเภทโพสต์เหล่านั้นออก
หน้าถัดไป: ส่ง meta.next_token จากการตอบกลับเป็น pagination_token ในคำขอถัดไป ใช้โทเคนโดยไม่ตีความและเข้ารหัส URL หยุดเมื่อไม่มีโทเคนถัดไป ถึงงบหน้า หรือโทเคนซ้ำ

การจัดการการตอบกลับ

อ่านผลลัพธ์ JSON โดยตรง

การค้นหาผู้ใช้ส่งบัญชีกลับใน data การตอบกลับไทม์ไลน์มีอาร์เรย์ data และ meta.result_count พร้อม meta.next_token เมื่อมีเคอร์เซอร์ถัดไป ข้อมูลผู้เขียนเพิ่มเติมอาจอยู่ใน includes.users

{
  "data": [],
  "meta": {
    "result_count": 0
  }
}

ตัวอย่างการตอบกลับไทม์ไลน์ว่าง ไม่ใช่ผลลัพธ์บัญชีสด ฟิลด์เสริมและเคอร์เซอร์อาจไม่มี หน้าว่างไม่ใช่หลักฐานว่าบัญชีไม่เคยโพสต์

ข้อผิดพลาดการตรวจสอบค่า

แก้พารามิเตอร์ที่ไม่ถูกต้องก่อนลองใหม่

หากไม่มี username หรือ max_results เกินช่วง จะส่ง HTTP 400 พร้อม success: false, error.code: 10001, error.message และ requestId ตรวจสอบข้อความและแก้คำขอก่อนลองใหม่ อย่าส่งซ้ำโดยไม่แก้ไข

การติดตามคำขอ

เก็บ ID คำขอ ไม่ใช่ข้อมูลรับรอง

เก็บส่วนหัวตอบกลับ X-Request-Id สำหรับฝ่ายสนับสนุนและติดตามคำขอ ตรวจสอบสถานะ HTTP ก่อนอ่านเพย์โหลดสำเร็จ และอย่าใส่คีย์ API หรือข้อมูลโปรไฟล์ที่ไม่จำเป็นในบันทึกแอป