API Threads Scoperta di profili
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- Normale
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
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
#| Nome | Posizione | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|---|
Authorization | header | string | Sì | - | Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice. |
platform | body | string | Sì | threads | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | discover_profiles | Identificativo della funzionalità, valore fisso. |
keyword | body.params | string | Sì | - | 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. |
since | body.params | date | No | - | 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 | body.params | date | No | - | 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 | body.params | integer (1–50) | No | 10 | 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. I valori più alti restituiscono 422 prima di qualsiasi addebito. |
Esempi di codice
#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
#{ "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.
| Campo | Significato |
|---|---|
username | Username (@handle). |
display_name | Nome visualizzato; può essere diverso da username. |
bio | Bio del profilo scritta dall'account; può contenere interruzioni di riga ed emoji. |
follower_count | Follower. null significa non reso noto, non 0. |
is_verified | Indica se la piattaforma ha verificato l'account. null significa che non è possibile determinarlo. |
url | Link al record sulla piattaforma. |
avatar_url | Link all'immagine dell'avatar. Alcune piattaforme restituiscono URL CDN con dimensioni specifiche, che possono scadere. |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
emails | Indirizzi email di contatto (un record può averne più di uno), passati così come sono e senza duplicati. |
phones | Mantiene il significato attribuito dalla piattaforma |
external_links | Mantiene 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.
Riferimenti ufficiali
#Usati solo per verificare oggetti e terminologia. Non implicano alcuna autorizzazione o approvazione di EveryInfra da parte della piattaforma.
- Documentazione ufficiale di Meta: la scoperta dei profili pubblici non è una ricerca utenti per parola chiave esatta ↗
Il `profile_lookup` ufficiale di Meta richiede uno username esatto ed è soggetto ad autorizzazioni, livelli di accesso e requisiti dell'account. La scoperta di profili candidati per parola chiave in questa API non va considerata equivalente alle ricerche esatte ufficiali, e la documentazione ufficiale non garantisce la copertura di tutti gli utenti.
Verificato il 2026-09-04