Age and Gender Detection
Das Profilbild eines Creators ist oft ein deutliches Porträt, und das Gesicht darin verrät auf einen Blick Altersgruppe und Geschlecht der Person hinter dem Konto. Diese Abfrage macht aus dem Bild eine geschätzte Altersspanne und ein Geschlecht mit Konfidenzwert, sodass sich Creator-Listen nach demografischen Merkmalen sortieren lassen, bevor jemand Zeit in die Sichtung von Inhalten steckt.
Funktionen der Age and Gender Detection API
- Geschätzte Altersspanneage_min und age_max liefern Unter- und Obergrenze des geschätzten Alters in Jahren, etwa 24 bis 30.
- Geschlecht mit Konfidenzwertgender gibt male oder female zurück, gender_confidence bewertet diese Schätzung von 0 bis 100.
- Fünf Netzwerke als Eingabeurl nimmt ein Profil auf Instagram, TikTok, YouTube, X oder Threads an, network und username kennzeichnen das Konto in der Zeile.
- Eine Zeile pro AbfrageJede Anfrage liefert genau eine Zeile mit id aus Netzwerk und Handle, etwa x:levelsio, sodass sich jede Schätzung direkt Ihrer Creator-Liste zuordnen lässt.
Parameter der Age and Gender Detection API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich | Eine Profil-URL auf Instagram, TikTok, YouTube, X oder Threads, deren Profilbild analysiert wird. |
So verwenden Sie die Age and Gender Detection API
Eine Creator-Profil-URL senden und die Schätzung von Alter und Geschlecht lesen.
- Senden Sie {"url": "https://x.com/levelsio"} per POST an /v1/creator/age-gender.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis status succeeded ist.
- Lesen Sie die einzelne Zeile aus results.items und prüfen Sie gender_confidence, bevor Sie den Geschlechtswert verwenden.
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"}'Anwendungsfälle der Age and Gender Detection API
- Creator passend zur Kampagnen-Persona auswählen: Eine Kandidatenliste nach Altersspanne und Geschlecht filtern, damit nur Creator, die zur Zielpersona passen, in die Inhaltsprüfung gehen.
- Creator-Datenbank segmentieren: age_min, age_max und gender zu jedem Datensatz hinzufügen und die Datenbank für Berichte und Planung in Altersgruppen gliedern.
- Creator-Auswahl ausbalancieren: Vor dem Start die Alters- und Geschlechterverteilung der geplanten Creator prüfen und nachsteuern, wenn eine Gruppe überwiegt.
Profi-Tipps zur Age and Gender Detection API
- Setzen Sie die Abfrage auf persönliche Konten mit deutlichem Porträt an: Ein klar sichtbares Gesicht liefert die verlässlichste Schätzung von Alter und Geschlecht.
- Legen Sie einen Mindestwert für gender_confidence fest, bevor Sie das Geschlecht in automatischen Filtern verwenden, und geben Sie niedrigere Werte in die Prüfung.
- Behandeln Sie die Schätzung als Spanne und vergleichen Sie Creator danach, ob age_min und age_max Ihre Zielaltersgruppe überschneiden.
Verwandte APIs
Ergänzend zur Age and Gender Detection API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Creator-Daten benötigen.
- Influencer Email Finder API — Öffentliche Business-E-Mails eines Creators aus einem Profil auf Instagram, TikTok, YouTube, X oder Facebook finden – jeweils mit den Seiten, auf denen sie stehen.
- Social Media Profile Finder API — Die Konten eines Creators in anderen Netzwerken aus einer Profil-URL finden – jeweils mit Konfidenz von 0 bis 1 und den Belegen für den Treffer.