L’outreach agli influencer si inceppa sempre negli stessi tre passaggi: trovare un indirizzo di contatto, collegare un profilo agli altri account del creator e filtrare un lungo elenco in base all’affinità con il pubblico prima che qualcuno guardi i contenuti. Di solito ogni passaggio è lavoro manuale tra bio, pagine link in bio e siti web.
Il 2026-11-17 SocQ ha lanciato la piattaforma Creator con un endpoint per ciascun passaggio. Tutti e tre ricevono l’URL di un singolo profilo pubblico. Questa guida spiega cosa restituiscono, come si fa la richiesta, quanto costano e quando usare ciascuno.
Risposta rapida: invia l’URL di un profilo in
urlaPOST /v1/creator/find-emails,/find-social-profileso/age-gender. InterrogaGET /v1/tasks/{task_id}e leggidata.results.items: email con le pagine in cui sono state trovate, account collegati con un punteggio di affidabilità, oppure una stima di fascia d’età e genere.
I nuovi endpoint Creator
1 credito SocQ = $0.005.
| Endpoint | Cosa restituisce | Social in input | Prezzo |
|---|---|---|---|
| Influencer Email Finder API | Le email aziendali pubbliche di un creator, ognuna con le pagine in cui è stata trovata | Instagram, TikTok, YouTube, X, Facebook | 8 crediti ($0.04) quando viene trovata almeno un’email; 0.5 crediti ($0.0025) quando non ne viene trovata nessuna |
| Social Media Profile Finder API | Una riga per ogni account che il creator gestisce su un altro social, con un’affidabilità da 0 a 1 e le prove | Instagram, TikTok, YouTube, X, Facebook | 8 crediti ($0.04) per ricerca |
| Age and Gender Detection API | Una fascia d’età e un genere stimati dalla foto profilo, con un punteggio di affidabilità | Instagram, TikTok, YouTube, X, Threads | 1 credito ($0.005) per ricerca |
Per tutti e tre, un profilo inesistente fa fallire l’attività con rimborso.
Autenticazione e flusso asincrono delle attività
Tutte le richieste SocQ si autenticano con una chiave API, e lo stesso header vale per l’invio, lo stato dell’attività e le richieste dei risultati:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Ogni raccolta viene eseguita come attività in background:
submit -> task_id -> queued -> running -> succeeded
\-> failed
La risposta all’invio contiene data.task_id e data.status. Interroga l’attività con quell’ID:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Quando status è succeeded, la risposta include la prima pagina di record normalizzati in data.results.items. limit vale 50 per impostazione predefinita e arriva fino a 500; se has_more è true, passa results.next_cursor come cursor. Mentre un’attività è queued, running o failed, l’endpoint restituisce i metadati dell’attività senza results.
Un callback_url facoltativo nel corpo dell’invio fa sì che SocQ invii un’unica POST con un riepilogo al termine dell’attività; leggi i record con GET /v1/tasks/{task_id}. Un timeout lato client non annulla l’attività, quindi riprendi con lo stesso ID invece di pagare un duplicato. 402 indica crediti insufficienti; 429 indica che la chiave ha raggiunto un limite di frequenza o di crediti.
Influencer Email Finder API: email aziendali pubbliche con le fonti
L’Influencer Email Finder API cerca le email che un creator rende pubbliche: nella bio, dietro le pagine link in bio, sui siti web collegati e sugli account del creator su altri social. Inserisci in url l’URL di un singolo profilo Instagram, TikTok, YouTube, X o Facebook. Un canale YouTube può essere indicato con @handle o con l’ID del canale.
curl -X POST "https://api.socq.ai/v1/creator/find-emails" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.instagram.com/miguelangeles"
}'
Quando viene trovata almeno un’email, il risultato è una riga con username, name ed emails. Ogni voce di emails contiene l’email e i source_urls, le pagine pubbliche in cui è stata trovata:
{
"id": "instagram:miguelangeles",
"username": "miguelangeles",
"emails": [
{
"email": "mgmt@irlangel.com",
"source_urls": [
"https://www.instagram.com/miguelangeles",
"https://www.youtube.com/@miguelangeles"
]
}
]
}
Le fonti permettono al team di outreach di vedere da dove arriva un indirizzo prima di usarlo, e di preferire gli indirizzi che compaiono su più pagine del creator stesso. Quando non viene trovata nessuna email, l’attività riesce comunque, non restituisce righe e costa 0.5 crediti. Documentazione: Influencer Email Finder.
Social Media Profile Finder API: lo stesso creator su altri social
Conosci un creator da Instagram e vuoi anche il suo TikTok e il suo YouTube? La Social Media Profile Finder API prende il profilo che hai e restituisce una riga per ogni altro account trovato per la stessa persona. Il profilo che hai inviato non viene ripetuto nei risultati.
curl -X POST "https://api.socq.ai/v1/creator/find-social-profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.instagram.com/miguelangeles"
}'
Ogni riga contiene l’url dell’account collegato, network, username, una confidence da 0 a 1 ed evidence: i segnali che collegano gli account, come same_handle, website_link o reciprocal_profile_link. source_network e source_url ripetono il profilo che hai cercato. Filtra su confidence ed evidence per tenere solo le corrispondenze di cui ti fidi. Una ricerca costa 8 crediti, qualunque sia il numero di account trovati. Documentazione: Social Media Profile Finder.
Age and Gender Detection API: filtro demografico dalla foto profilo
L’Age and Gender Detection API ordina un elenco di creator per dati demografici prima che tu passi tempo a guardarne i contenuti. La stima viene ricavata dal volto nella foto profilo. Inserisci l’URL di un singolo profilo Instagram, TikTok, YouTube, X o Threads.
curl -X POST "https://api.socq.ai/v1/creator/age-gender" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://x.com/levelsio"
}'
La riga contiene network, username, age_min e age_max (la fascia d’età stimata in anni), gender (male o female) e gender_confidence da 0 a 100. Funziona meglio con account personali che hanno una foto del volto nitida; loghi e foto di gruppo lasciano vuoti i campi di età e genere. Considera il risultato una stima basata sulla foto, non un dato verificato sulla persona. Documentazione: Age and Gender Detection.
Combinare i tre endpoint
Una pipeline di outreach tipica per un elenco di URL di profili di creator:
- Filtra con Age and Gender Detection a 1 credito per profilo, tenendo i creator la cui stima è adatta alla tua campagna.
- Espandi ogni creator selezionato con Social Media Profile Finder per raccogliere i suoi altri account, tenendo le corrispondenze sopra una soglia di affidabilità.
- Contatta con Influencer Email Finder e salva ogni email con i suoi
source_urls.
Per 100 creator selezionati, i passaggi 2 e 3 costano al massimo 1,600 crediti ($8.00), più 100 crediti ($0.50) per il passaggio 1. Se hai già gli URL delle pagine link in bio, la Link in Bio API legge quelle pagine in blocco a 0.5 crediti ciascuna. Per un confronto più ampio tra fornitori di dati sui creator, leggi alternative a ScrapeCreators.
Domande frequenti (FAQ)
Che cos’è un’API per trovare le email degli influencer?
Un’API che riceve il profilo social di un creator e restituisce le email di contatto pubbliche associate. La versione di SocQ restituisce ogni email con le pagine pubbliche in cui è stata trovata.
Restituisce email private o personali?
Restituisce le email che il creator rende pubbliche, nella bio, sulle pagine link in bio, sui siti collegati o sugli altri suoi account, insieme a quelle pagine di origine. Usale nel rispetto delle norme applicabili su privacy e anti-spam.
Pago anche quando non viene trovata nessuna email?
Sì, 0.5 crediti. L’attività riesce senza righe. Quando viene trovata almeno un’email la ricerca costa 8 crediti. Un profilo inesistente fa fallire l’attività con rimborso.
Quanto sono affidabili i profili collegati?
Ogni corrispondenza ha una confidence da 0 a 1 e le evidence che la sostengono, per esempio i profili che si collegano a vicenda. Imposta la tua soglia e conserva le prove insieme alla corrispondenza.
Perché età e genere sono vuoti per alcuni profili?
La stima deriva da un volto nella foto profilo. Loghi e foto di gruppo lasciano vuoti i campi di età e genere.
CREATOR API
Prova il flusso di lavoro con un URL pubblico di Creator
Invia input pubblici e ricevi record normalizzati con un contesto di origine tracciabile.
Scopri le API di Creator