Age and Gender Detection
La foto de perfil de un creador suele ser un retrato nítido, y el rostro que muestra permite leer de un vistazo la franja de edad y el género de la persona detrás de la cuenta. Esta búsqueda convierte esa foto en un rango de edad estimado y un género con puntuación de confianza, de modo que las listas de creadores pueden ordenarse por datos demográficos antes de dedicar tiempo a revisar contenido.
Funcionalidades de la Age and Gender Detection API
- Rango de edad estimadoage_min y age_max dan el límite inferior y superior de la edad estimada en años, por ejemplo de 24 a 30.
- Género con puntuación de confianzagender devuelve male o female, y gender_confidence califica esa estimación de 0 a 100.
- Cinco redes como entradaurl acepta un perfil de Instagram, TikTok, YouTube, X o Threads, y network y username identifican la cuenta en la fila.
- Una fila por consultaCada solicitud devuelve exactamente una fila con un id que combina red e identificador, como x:levelsio, para cruzar cada estimación directamente con su lista de creadores.
Parámetros de la Age and Gender Detection API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio | Una URL de perfil de Instagram, TikTok, YouTube, X o Threads cuya foto de perfil se analiza. |
Cómo usar la Age and Gender Detection API
Envíe la URL de un perfil de creador y lea la estimación de edad y género.
- Envíe {"url": "https://x.com/levelsio"} por POST a /v1/creator/age-gender.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- Lea la fila única en results.items y revise gender_confidence antes de usar el valor de género.
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"}'Casos de uso de la Age and Gender Detection API
- Preseleccionar según el buyer persona: Filtrar una lista de candidatos por rango de edad y género para que solo pasen a revisión de contenido los creadores que encajan con el perfil objetivo de la campaña.
- Segmentar una base de creadores: Añadir age_min, age_max y gender a cada registro y agrupar la base por franjas de edad para reportes y planificación.
- Equilibrar una selección de creadores: Revisar antes del lanzamiento la composición por edad y género de los creadores previstos y ajustarla si un grupo predomina.
Consejos de expertos para la Age and Gender Detection API
- Úsela con cuentas personales que tengan un retrato nítido: un rostro bien visible da la estimación de edad y género más fiable.
- Fije un mínimo de gender_confidence antes de usar el género en filtros automáticos y deje las puntuaciones más bajas para revisión.
- Trate la estimación como un rango y compare a los creadores según si age_min y age_max se solapan con la franja objetivo.
APIs relacionadas
Además de la Age and Gender Detection API, use estas APIs cuando necesite otro tipo de datos públicos de Creator.
- Influencer Email Finder API — Encuentra los correos comerciales públicos de un creador desde un perfil de Instagram, TikTok, YouTube, X o Facebook, cada uno con las páginas donde aparece.
- Social Media Profile Finder API — Encuentra desde una URL de perfil las cuentas que un creador tiene en otras redes, cada una con una confianza de 0 a 1 y la evidencia de la coincidencia.