Age and Gender Detection
La photo de profil d’un créateur est souvent un portrait net, et le visage qu’elle montre donne d’un coup d’œil la tranche d’âge et le genre de la personne derrière le compte. Cette recherche transforme la photo en tranche d’âge estimée et en genre assorti d’un score de confiance, pour trier une liste de créateurs par profil démographique avant de consacrer du temps à la revue des contenus.
Fonctionnalités de la Age and Gender Detection API
- Tranche d’âge estiméeage_min et age_max donnent la borne basse et la borne haute de l’âge estimé, en années, par exemple 24 à 30.
- Genre avec score de confiancegender renvoie male ou female, et gender_confidence note cette estimation de 0 à 100.
- Cinq réseaux en entréeurl accepte un profil Instagram, TikTok, YouTube, X ou Threads, et network et username identifient le compte sur la ligne.
- Une ligne par rechercheChaque requête renvoie exactement une ligne dont id associe réseau et identifiant, comme x:levelsio, pour rattacher chaque estimation directement à votre liste de créateurs.
Paramètres de la Age and Gender Detection API
| Paramètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire | Une URL de profil Instagram, TikTok, YouTube, X ou Threads dont la photo de profil est analysée. |
Comment utiliser la Age and Gender Detection API
Envoyez l’URL d’un profil de créateur et lisez l’estimation d’âge et de genre.
- Envoyez {"url": "https://x.com/levelsio"} en POST à /v1/creator/age-gender.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- Lisez la ligne unique dans results.items et vérifiez gender_confidence avant d’utiliser la valeur de genre.
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"}'Cas d’usage de la Age and Gender Detection API
- Présélectionner selon le persona de campagne : Filtrez une liste de candidats par tranche d’âge et genre pour n’envoyer en revue de contenu que les créateurs qui correspondent au persona visé.
- Segmenter une base de créateurs : Ajoutez age_min, age_max et gender à chaque fiche et répartissez la base en tranches d’âge pour le reporting et la planification.
- Équilibrer une sélection de créateurs : Vérifiez la répartition par âge et par genre des créateurs prévus avant le lancement et ajustez-la si un groupe domine.
Conseils d’expert pour la Age and Gender Detection API
- Utilisez cette recherche sur des comptes personnels avec un portrait net : un visage bien visible donne l’estimation d’âge et de genre la plus fiable.
- Fixez un minimum de gender_confidence avant d’utiliser le genre dans des filtres automatiques et envoyez les scores inférieurs en revue.
- Traitez l’estimation comme une plage et comparez les créateurs selon que age_min et age_max recoupent la tranche visée.
API associées
En complément de la Age and Gender Detection API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Creator.
- Influencer Email Finder API — Trouvez les e-mails professionnels publics d’un créateur à partir d’un profil Instagram, TikTok, YouTube, X ou Facebook, chacun avec les pages où il figure.
- Social Media Profile Finder API — Trouvez à partir d’une URL de profil les comptes qu’un créateur tient sur d’autres réseaux, chacun avec une confiance de 0 à 1 et les preuves de la correspondance.