API Threads Scoperta di profili

POST

Stato di salute dell'API

Operatività nelle ultime 24 ore
Normale
  • Buono / normale
  • Disponibile
  • Limitato
  • Quasi del tutto inattivo
Normale

Ultime 24 ore

Ultimi 30 giorni

Scopri profili di creator Threads legati a una parola chiave. Ottieni bio, numero di follower, verifica, link esterni ed eventuali email o numeri di telefono indicati. Viene eseguito come job asincrono, quindi leggi il risultato finale, non la prima risposta di stato. Una corrispondenza non prova né l'identità né l'idoneità.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su threads e action impostato su discover_profiles. Prezzo $0.56 per 1.000 richieste ($0.000556 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Asincrona per impostazione predefinita: restituisce prima un job_id; esegui il polling su GET /api/v1/jobs/{job_id}.

Prompt per l'AI

#
Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Threads Scoperta di profili di EveryInfra (threads/discover_profiles).

Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su threads e action su discover_profiles, e inserisci i parametri in params.
- Parametri obbligatori:
  - keyword: Indica la query di ricerca per trovare post pubblici con search o profili di creator con discover_profiles.
- Parametri facoltativi:
  - since: Parametro condiviso per il limite inferiore della data in discover_profiles. Non è garantito che filtri i profili trovati e non filtra per data di creazione dell'account.
  - until: Parametro condiviso per il limite superiore della data in discover_profiles. Non garantisce la copertura completa dei creator di quel periodo, e search non ha un filtro per data.
  - limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 50. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. (predefinito: 10)
- Restituisce un elenco di record. Campi principali di ogni record: username, display_name, bio, follower_count, is_verified, url, avatar_url, emails, phones, external_links.
- Esempio di corpo della richiesta:
{
  "platform": "threads",
  "action": "discover_profiles",
  "params": {
    "keyword": "coffee"
  }
}
- Prezzo: $0.56 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Questo endpoint è asincrono per impostazione predefinita: restituisce 202 e un job_id, poi esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} finché lo stato non è succeeded o failed.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.

Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.

Parametri della richiesta

#
NomePosizioneTipoObbligatorioPredefinitoDescrizione
AuthorizationheaderstringSì-Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice.
platformbodystringSìthreadsIdentificativo della piattaforma, valore fisso.
actionbodystringSìdiscover_profilesIdentificativo della funzionalità, valore fisso.
keywordbody.paramsstringSì-Indica la query di ricerca per trovare post pubblici con search o profili di creator con discover_profiles. L'azione discover_profiles è asincrona: la risposta iniziale con lo stato del task non va interpretata come l'elenco finale dei creator.
sincebody.paramsdateNo-Parametro condiviso per il limite inferiore della data in discover_profiles. Non è garantito che filtri i profili trovati e non filtra per data di creazione dell'account.
untilbody.paramsdateNo-Parametro condiviso per il limite superiore della data in discover_profiles. Non garantisce la copertura completa dei creator di quel periodo, e search non ha un filtro per data.
limitbody.paramsinteger (1–50)No10Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 50. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. I valori più alti restituiscono 422 prima di qualsiasi addebito.

Esempi di codice

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "threads",
  "action": "discover_profiles",
  "params": {
    "keyword": "coffee"
  }
}'

Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.

Esempio di risposta

#
Acquisita il October 24, 2026 at 18:28 (UTC) chiamando questa API con i parametri dell'esempio di codice qui sopra. results e count sono la risposta reale di quella chiamata, da cui sono state rimosse le informazioni personali (nomi, handle, avatar, link ai profili, recapiti); l'elenco conserva i primi 2. id, billing e quota cambiano a ogni chiamata, quindi ne viene mostrata solo la struttura.
json
{  "id": "req_…",  "platform": "threads",  "action": "discover_profiles",  "results": [    {      "username": "•••",      "display_name": "•••",      "bio": "•••",      "follower_count": 99866,      "is_verified": true,      "url": "https://www.threads.com/•••",      "avatar_url": "https://scontent-den2-1.cdninstagram.com/•••",      "platform": "threads"    },    {      "username": "•••",      "display_name": "•••",      "bio": "•••",      "follower_count": 7680,      "is_verified": false,      "url": "https://www.threads.com/•••",      "avatar_url": "https://scontent-lax3-1.cdninstagram.com/•••",      "platform": "threads",      "external_links": [        "https://lin.ee/•••"      ]    }  ],  "count": 10,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Campi della risposta

#

I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.

CampoSignificato
usernameUsername (@handle).
display_nameNome visualizzato; può essere diverso da username.
bioBio del profilo scritta dall'account; può contenere interruzioni di riga ed emoji.
follower_countFollower. null significa non reso noto, non 0.
is_verifiedIndica se la piattaforma ha verificato l'account. null significa che non è possibile determinarlo.
urlLink al record sulla piattaforma.
avatar_urlLink all'immagine dell'avatar. Alcune piattaforme restituiscono URL CDN con dimensioni specifiche, che possono scadere.
platformIdentificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).
emailsIndirizzi email di contatto (un record può averne più di uno), passati così come sono e senza duplicati.
phonesMantiene il significato attribuito dalla piattaforma
external_linksMantiene il significato attribuito dalla piattaforma

Errori e addebiti

#
401
Chiave mancante o non valida.
402
Saldo insufficiente. Effettua prima una ricarica.
422
Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
429
Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
503
Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
Risposta 200 vuota
Nessun dato. Nessun addebito.

Errori

Riferimenti ufficiali

#

Usati solo per verificare oggetti e terminologia. Non implicano alcuna autorizzazione o approvazione di EveryInfra da parte della piattaforma.

Le nostre statistiche di visita interne sono sempre attive. Google Analytics viene caricato solo se scegli «Consenti analisi». Informativa sulla privacy