Twitter API

API Twitter: wyszukiwanie użytkowników, osie czasu i stronicowanie

Zintegruj punkty końcowe Twitter / X w API Hop z uwierzytelnianiem Bearer, wyborem pól użytkownika i tweetów, stronicowaniem kursorowym i obsługą błędów walidacji.

Ustal ID użytkownika na podstawie nazwy, pobierz jego oś czasu i przekaż zwrócony token następnej strony, aby pobrać kolejną. Udane wywołania zwracają JSON bezpośrednio; te punkty końcowe nie wymagają odpytywania Jobs.

Uzyskaj klucz API Przeglądaj katalog API

Do konkretnego zadania

Zaimplementuj trzy obsługiwane operacje GET i przetwarzaj ich wyniki.

Znajdź konto według nazwy użytkownika i wybierz zwracane pola profilu.

Odśwież znane konto według ID użytkownika bez ponownego wyszukiwania nazwy.

Pobieraj strony osi czasu z limitem rozmiaru strony i tokenem stronicowania.

Jednostka rozliczeniowa

Poznaj sposób pomiaru użycia

USD za żądanie.

Ograniczenia operacyjne

Zwracane pola zależą od udokumentowanych parametrów zapytania i odpowiedzi dostawcy.
max_results musi być liczbą całkowitą od 1 do 100. Strona może zawierać mniej wyników.
Zachowuj ID użytkowników i tweetów jako ciągi znaków, aby uniknąć utraty precyzji liczb.

Przewodniki integracji

Wybierz następny krok

Zaplanuj odświeżanie i przechowywanie Ogranicz liczbę żądań, usuwaj duplikaty wpisów i zapisuj czas pobrania w aplikacji. Katalog API danych Sprawdź aktualne produkty danych, operacje i ceny za żądanie.

Aktualny zakres katalogu

Dostępne API i jednostki rozliczeniowe

Porównaj ID API, operacje, dostawców i ceny. Przed oszacowaniem kosztów użycia sprawdź datę katalogu i jednostkę rozliczeniową każdej operacji.

API danych

Twitter User Data

twitter-user-data Dokumentacja

aktywne

Pobieraj publiczne profile i osie czasu użytkowników Twitter / X.

Dostawca: Twitter / X Data
Jednostka rozliczeniowa: żądanie
Formaty i punkty końcowe API: Punkty końcowe żądań znajdziesz w poniższych operacjach.
Opublikowane możliwości: Wyszukiwanie użytkowników, Oś czasu użytkownika

Opublikowane operacje

GET /v1/twitter/users Pobierz użytkownika według nazwy
GET /v1/twitter/users/{id} Pobierz użytkownika według ID
GET /v1/twitter/users/{id}/tweets Pobierz wpisy użytkownika

Cena API Hop

Żądanie: $0.0020 /żądanie

Pobierz użytkownika według nazwy

GET /v1/twitter/users

Cena API Hop

Żądanie: $0.0020 /żądanie

Pobierz użytkownika według ID

GET /v1/twitter/users/{id}

Cena API Hop

Żądanie: $0.0020 /żądanie

Pobierz wpisy użytkownika

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

Cena API Hop

Żądanie: $0.0020 /żądanie

Otwórz pełny katalog API

Przykład żądania

Zacznij od udokumentowanej operacji

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())

Użyj bazowego URL API z dokumentacji konta i zastąp symbole zastępcze przykładu. Przekaż klucz API w nagłówku Authorization; nigdy nie umieszczaj go w URL ani pliku zapisanym w repozytorium.

Punkty końcowe

Trzy operacje dotyczące kont i osi czasu

Znajdź według nazwy użytkownika GET /v1/twitter/users?username=<USERNAME>

Odczytaj zwrócone data.id jako ciąg znaków do kolejnych żądań.

Znajdź według ID użytkownika GET /v1/twitter/users/<USER_ID>

Pobierz znane konto i opcjonalnie wybierz pola jego profilu.

Oś czasu użytkownika GET /v1/twitter/users/<USER_ID>/tweets

Ustaw max_results i przekaż pagination_token dla kolejnych stron.

Parametry zapytania

Wybierz pola i stronicuj oś czasu

Wyszukiwanie konta: username jest wymagane w /v1/twitter/users. Oba punkty końcowe wyszukiwania akceptują listę user.fields rozdzielaną przecinkami, na przykład description,public_metrics.
Rozmiar strony: max_results przyjmuje liczby całkowite od 1 do 100. To górna granica rozmiaru strony, a nie gwarancja takiej liczby wpisów.
Pola osi czasu: Użyj tweet.fields=created_at,public_metrics do znaczników czasu i metryk. Żądaj expansions=author_id z user.fields, gdy potrzebujesz dostępnych informacji o autorze. Użyj exclude=replies,retweets, aby wykluczyć te typy wpisów.
Następna strona: Przekaż meta.next_token z odpowiedzi jako pagination_token w kolejnym żądaniu. Nie interpretuj tokenu i zakoduj go dla URL. Zatrzymaj się, gdy nie ma następnego tokenu, osiągnięto budżet stron lub token się powtarza.

Obsługa odpowiedzi

Odczytuj wyniki JSON bezpośrednio

Wyszukiwanie użytkownika zwraca konto w data. Odpowiedzi osi czasu zawierają tablicę data i meta.result_count oraz meta.next_token, gdy dostępny jest kolejny kursor. Rozszerzone dane autorów mogą wystąpić w includes.users.

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

Przykładowa odpowiedź pustej osi czasu, a nie wynik z rzeczywistego konta. Opcjonalne pola i kursory mogą nie występować. Pusta strona nie dowodzi, że konto nigdy nic nie opublikowało.

Błędy walidacji

Popraw nieprawidłowe parametry przed ponowieniem

Brak username lub max_results poza zakresem zwraca HTTP 400 z success: false, error.code: 10001, error.message i requestId. Sprawdź komunikat i popraw żądanie zamiast ponawiać je bez zmian.

Śledzenie żądań

Zachowaj ID żądania, a nie poświadczenie

Zachowaj nagłówek odpowiedzi X-Request-Id na potrzeby pomocy i śledzenia żądań. Sprawdź status HTTP przed odczytaniem udanej odpowiedzi i nie zapisuj kluczy API ani zbędnych danych profilu w dziennikach aplikacji.