Twitter Search
I risultati di ricerca di X sono post pubblici selezionati per una query, con lingua, autore, contenuti multimediali, entità, contesto della conversazione e engagement visibile di ogni corrispondenza. Tenere la query accanto a ogni record rende più facili da verificare le scansioni periodiche di un tema, l’ascolto durante i lanci e il confronto tra insiemi di risultati.
Funzionalità della Twitter Search API
- Scoperta da una sola espressioneInvia una parola chiave o un’espressione di ricerca non vuota e trasforma i post pubblici di X corrispondenti in record strutturati.
- Ordinamento per due modalità di ricercaUsa latest per seguire le corrispondenze recenti o top per esaminare quelle più in vista; latest è selezionato per impostazione predefinita.
- Un limite pratico ai risultati di ricercaRichiedi da 20 a 2.000 risultati a scatti di 20 per impostare la profondità massima della raccolta di ricerca.
- Corrispondenze che conservano la propria queryCombina testo, autore, engagement, contenuti multimediali, entità, timestamp e campi di relazione con extra.search_query e collected_at.
Parametri della Twitter Search API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | Parola chiave o espressione di ricerca dei post di X obbligatoria e non vuota, usata per trovare i post pubblici corrispondenti. |
results_limit | Facoltativo | Limite facoltativo dei risultati richiesti. Il valore predefinito è 20 e sono accettati i multipli di 20 da 20 a 2.000. |
sort_by | Facoltativo | Ordinamento facoltativo: latest per le corrispondenze recenti o top per quelle più in vista. Il valore predefinito è latest. |
Come usare la Twitter Search API
Formula una domanda di ricerca precisa come espressione di ricerca, scegli l’ordinamento più adatto e conserva la query insieme ai post ottenuti.
- Scrivi un’unica espressione mirata e non vuota per i post di X che vuoi trovare.
- Seleziona latest o top e scegli un results_limit da 20 a 2.000 a scatti di 20.
- Invia con POST la richiesta a /v1/x/search, poi interroga /v1/tasks/{task_id} fino al completamento.
- Salva data.results.items, poi segui next_cursor finché has_more diventa false.
curl -X POST "https://api.socq.ai/v1/x/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"artificial intelligence","results_limit":40,"sort_by":"latest"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasi d’uso della Twitter Search API
- Ascoltare intorno a un lancio: Cerca il nome di un prodotto, di una release, di una conferenza o di una campagna e organizza i post corrispondenti per momento di pubblicazione e di raccolta.
- Monitorare le menzioni di brand e prodotti: Riunisci autori, testo, engagement visibile, hashtag, menzioni e contenuti multimediali per un nome o una frase specifici.
- Mappare un tema in evoluzione: Usa i risultati latest per seguire i nuovi post e i risultati top per esaminare i contenuti più in vista all’interno della stessa espressione di ricerca.
- Mantenere un dataset di query periodiche: Salva extra.search_query con ogni corrispondenza, riesegui un’espressione versionata e aggiungi solo gli ID dei post mai visti prima.
Consigli degli esperti per la Twitter Search API
- Parti da un’espressione mirata, controlla le corrispondenze e allarga la formulazione solo se la copertura è troppo stretta.
- Scegli latest per l’ascolto sensibile al tempo e top quando contano più le corrispondenze in vista che la cronologia.
- Imposta results_limit come multiplo di 20 e interpretalo come un tetto, non come un numero di risultati garantito.
- Versiona la query ogni volta che cambiano i suoi termini, così gli insiemi di risultati periodici restano confrontabili.
- Deduplica per id del post conservando extra.search_query e collected_at come contesto di scoperta.
API correlate
Oltre alla Twitter Search API, usa queste API quando ti serve un altro tipo di dati pubblici di X.
- Twitter Tweet Scraper API — Recupera testo dei post pubblici, autori, engagement, media, hashtag, menzioni e relazioni della conversazione dagli URL di stato di x.com o twitter.com.
- Twitter Profile Scraper API — Recupera identità dell’account pubblico, bio, avatar, immagini di copertina, stato dell’account e statistiche visibili del pubblico a partire dal nome utente.
- X Post Replies API — Raccoglie le risposte pubbliche dagli URL dei post X con ordinamento selezionabile, testo delle risposte, autori, engagement visibile, media e contesto del post principale.
- X Trends API — Raccoglie gli snapshot attuali delle tendenze pubbliche di X per WOEID numerici noti con posizione di origine, query, descrizione e contesto della località.
- Twitter User Search API — Trova account X pubblici per parola chiave.
- X Communities Search API — Trova community per parola chiave, con numero di membri e link per gli endpoint dei membri e dei post.
- Twitter User Tweets Scraper API
- X Followers List API
- X Following List API
- X Post Quotes API
- X Post Retweeters API
- Twitter Mentions API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API