Age and Gender Detection
La foto profilo di un creator è spesso un primo piano nitido, e il volto che mostra rivela a colpo d’occhio fascia d’età e genere della persona dietro l’account. Questa ricerca trasforma la foto in una fascia d’età stimata e in un genere con punteggio di confidenza, così puoi ordinare le liste di creator per dati demografici prima di dedicare tempo alla revisione dei contenuti.
Funzionalità della Age and Gender Detection API
- Fascia d’età stimataage_min e age_max indicano il limite inferiore e superiore dell’età stimata in anni, per esempio da 24 a 30.
- Genere con punteggio di confidenzagender restituisce male o female, e gender_confidence valuta la stima da 0 a 100.
- Cinque reti in ingressourl accetta un profilo Instagram, TikTok, YouTube, X o Threads, mentre network e username identificano l’account nella riga.
- Una riga per ricercaOgni richiesta restituisce esattamente una riga con un id che unisce rete e handle, come x:levelsio, così ogni stima si ricollega subito alla tua lista di creator.
Parametri della Age and Gender Detection API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio | Un URL di profilo Instagram, TikTok, YouTube, X o Threads di cui viene analizzata la foto profilo. |
Come usare la Age and Gender Detection API
Invia l’URL di un profilo creator e leggi la stima di età e genere.
- Invia {"url": "https://x.com/levelsio"} in POST a /v1/creator/age-gender.
- Interroga GET /v1/tasks/{task_id} finché status non è succeeded.
- Leggi l’unica riga in results.items e controlla gender_confidence prima di usare il valore del genere.
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"}'Casi d’uso della Age and Gender Detection API
- Selezionare creator in linea con la buyer persona: Filtra una lista di candidati per fascia d’età e genere, così passano alla revisione dei contenuti solo i creator che corrispondono al target della campagna.
- Segmentare un database di creator: Aggiungi age_min, age_max e gender a ogni scheda e suddividi il database in fasce d’età per report e pianificazione.
- Bilanciare una selezione di creator: Prima del lancio verifica la composizione per età e genere dei creator previsti e correggila se un gruppo prevale.
Consigli degli esperti per la Age and Gender Detection API
- Usala su account personali con un primo piano nitido: un volto ben visibile dà la stima di età e genere più affidabile.
- Fissa un minimo di gender_confidence prima di usare il genere nei filtri automatici e lascia i punteggi più bassi alla revisione.
- Considera la stima come un intervallo e confronta i creator in base a quanto age_min e age_max si sovrappongono alla fascia target.
API correlate
Oltre alla Age and Gender Detection API, usa queste API quando ti serve un altro tipo di dati pubblici di Creator.
- Influencer Email Finder API — Trova le email business pubbliche di un creator da un profilo Instagram, TikTok, YouTube, X o Facebook, ognuna con le pagine in cui compare.
- Social Media Profile Finder API — Trova da un URL di profilo gli account che un creator gestisce su altre reti, ognuno con una confidenza da 0 a 1 e le prove della corrispondenza.