x/
search-users

Cerca per parola chiave gli account utente pubblici di X e ottieni identità normalizzata, bio, stato di verifica e metriche del pubblico.

Twitter User Search API

Ricerca utenti
Scoperta di account
Profili normalizzati
0,6 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 User Search

Per trovare su X i profili di creator, aziende ed esperti rilevanti serve una corrispondenza mirata per parola chiave tra gli handle e le bio degli account. I profili normalizzati restituiscono nomi utente, nomi visualizzati, bio, contesto geografico, numero di follower e badge di verifica.

Funzionalità della Twitter User Search API

  • Corrispondenza degli account per parola chiaveInvia qualsiasi termine di ricerca per scoprire i profili pubblici rilevanti tra nomi, nomi utente e bio degli account.
  • Attributi del profilo normalizzatiRicevi oggetti coerenti con ID utente, handle, nome visualizzato, avatar, banner e testo della biografia.
  • Metriche del pubblicoRileva il numero attuale di follower, seguiti, post totali, contenuti multimediali e Mi piace per ogni account restituito.
  • Flag di verifica e di statoIndividua i badge blu di verifica, i flag dei bot automatici, lo stato di account protetto e le stringhe di località.

Parametri della Twitter User Search API

ParametriObbligatorioDescrizione
queryObbligatorioParola chiave di ricerca per trovare i profili utente pubblici di X corrispondenti.
results_limitFacoltativoNumero massimo di profili utente da restituire; deve essere un multiplo di 20 compreso tra 20 e 2.000, con 20 come valore predefinito.

Come usare la Twitter User Search API

Invia una ricerca per parola chiave come attività asincrona, quindi scorri i profili utente normalizzati con la paginazione.

  1. Imposta il termine di ricerca in query e indica results_limit come multiplo di 20 (fino a 2.000).
  2. Invia una richiesta POST a /v1/x/search-users con la tua chiave API di SocQ.
  3. Interroga /v1/tasks/{task_id} finché lo stato dell’attività diventa succeeded.
  4. Recupera i record normalizzati degli account da data.results.items.
curl -X POST "https://api.socq.ai/v1/x/search-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"OpenAI","results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then fetch data.results.items.

Casi d’uso della Twitter User Search API

  • Scoperta di influencer ed esperti di settore: Trova esperti influenti di un ambito, giornalisti e opinion leader cercando la terminologia del settore.
  • Verifica degli account dei brand: Scopri gli handle dei brand, le filiali regionali localizzate o gli account non ufficiali dei fan su tutta la piattaforma.
  • Generazione di elenchi di contatti per l’outreach: Costruisci elenchi di potenziali contatti tra i professionisti rilevanti, filtrati per parole chiave nella loro bio pubblica.

Consigli degli esperti per la Twitter User Search API

  • Usa questo endpoint per scoprire account; usa X Search quando vuoi trovare singoli post.
  • results_limit deve essere un multiplo di 20 (per esempio 20, 40, 100) per allinearsi ai blocchi di paginazione a monte.
  • Controlla le proprietà is_verified e verified_type per verificare se un account è autenticato ufficialmente.
  • Passa i nomi utente trovati a X User Posts o X Following List per esplorare meglio il loro grafo del pubblico.

Oltre alla Twitter User Search API, usa queste API quando ti serve un altro tipo di dati pubblici di X.

  • 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.
  • Twitter User Tweets Scraper API — Raccoglie i post pubblici recenti, autori, media, hashtag, menzioni ed engagement a partire dal nome utente, escludendo le risposte.
  • Twitter Search API — Trova post pubblici tramite espressione di ricerca con ordinamento per più recenti o più popolari e un limite di risultati configurabile.
  • X Followers List API — Raccoglie identità degli account follower pubblici e metriche visibili dei profili per uno o più nomi utente X.
  • 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à.
  • 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 User Search API — FAQ

Twitter User Search API cerca account utente pubblici e profili di creator su X tramite query di testo. Restituisce record di profilo normalizzati con numero di follower, bio, badge di verifica e URL degli avatar.

L’endpoint X Search cerca i post pubblici che corrispondono alle parole chiave, mentre Twitter User Search cerca in modo specifico account utente e profili di canali.

Il provider a monte fornisce i risultati della ricerca utenti in pagine fisse da 20 elementi, quindi i limiti richiesti devono essere un multiplo esatto di 20.