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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | Parola chiave di ricerca per trovare i profili utente pubblici di X corrispondenti. |
results_limit | Facoltativo | Numero 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.
- Imposta il termine di ricerca in query e indica results_limit come multiplo di 20 (fino a 2.000).
- Invia una richiesta POST a /v1/x/search-users con la tua chiave API di SocQ.
- Interroga /v1/tasks/{task_id} finché lo stato dell’attività diventa succeeded.
- 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.
API correlate
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.
- Twitter Tweet Scraper API
- X Following List API
- X Post Quotes API
- X Post Replies 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