x/
search

Cerca i post pubblici di X con un’unica espressione mirata, scegli l’ordinamento per più recenti o più popolari e ricevi contenuti, autori, engagement, contenuti multimediali, entità e contesto della query di origine.

Twitter Search API

Scoperta per query
Latest o Top
Traccia della query di origine
0,7 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
queryObbligatorioParola chiave o espressione di ricerca dei post di X obbligatoria e non vuota, usata per trovare i post pubblici corrispondenti.
results_limitFacoltativoLimite facoltativo dei risultati richiesti. Il valore predefinito è 20 e sono accettati i multipli di 20 da 20 a 2.000.
sort_byFacoltativoOrdinamento 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.

  1. Scrivi un’unica espressione mirata e non vuota per i post di X che vuoi trovare.
  2. Seleziona latest o top e scegli un results_limit da 20 a 2.000 a scatti di 20.
  3. Invia con POST la richiesta a /v1/x/search, poi interroga /v1/tasks/{task_id} fino al completamento.
  4. 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 true

Casi 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.

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.

Esplora altre piattaforme

Combina i dati di X con i dati pubblici delle altre piattaforme social supportate.

Twitter Search API — FAQ

Twitter Search API trova i post pubblici di X per una singola espressione di ricerca. Restituisce contenuto dei post, autori, engagement, contenuti multimediali, entità, relazioni e query di origine in forma strutturata.

Usa una sola parola chiave o espressione di ricerca non vuota che descriva il brand, il prodotto, l’evento, la frase o il tema da approfondire.

Scegli latest per dare priorità alle corrispondenze recenti e top per esaminare quelle più in vista. latest è il valore predefinito.

results_limit ha 20 come valore predefinito e accetta i multipli di 20 da 20 a 2.000. Definisce il numero massimo di risultati richiesti.

Un risultato può includere testo, lingua, dati dell’autore, engagement visibile, contenuti multimediali, hashtag, menzioni, timestamp e relazioni della conversazione.

Sì. extra.search_query riporta l’espressione inviata, così la corrispondenza resta collegata alla sua regola di scoperta.

Il limite è un tetto di raccolta, mentre il numero effettivo dipende dalle corrispondenze pubbliche idonee disponibili al momento dell’esecuzione dell’attività.

Ogni risultato di ricerca normalizzato restituito costa 0,7 crediti SocQ.