Age and Gender Detection
A creator's profile photo is often a clear headshot, and the face in it gives a quick read on the age bracket and gender of the person behind the account. This lookup turns that photo into an estimated age range and a gender with a confidence score, so creator lists can be sorted by demographic before anyone spends time reviewing content.
Age and Gender Detection API Features
- Estimated age rangeage_min and age_max give the lower and upper bound of the estimated age in years, such as 24 to 30.
- Gender with a confidence scoregender returns male or female, and gender_confidence rates that estimate from 0 to 100.
- Five networks as inputurl accepts an Instagram, TikTok, YouTube, X or Threads profile, and network and username identify the account on the row.
- One row for every lookupEach request returns exactly one row with id set to network and handle, such as x:levelsio, so every estimate joins straight back to your creator list.
Age and Gender Detection API Parameters
| Parameters | Required | Description |
|---|---|---|
url | Required | One Instagram, TikTok, YouTube, X or Threads profile URL whose profile photo is analyzed. |
How to Use the Age and Gender Detection API
Send one creator profile URL to the Age and Gender Detection API and read the estimate.
- POST {"url": "https://x.com/levelsio"} to /v1/creator/age-gender.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- Read the single row from results.items and check gender_confidence before using the gender value.
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"}'Age and Gender Detection API Use Cases
- Shortlist creators for a campaign persona: Run a candidate list through the Age and Gender Detection API and filter by age range and gender so only creators who match the campaign's target persona move on to content review.
- Segment a creator database: Add age_min, age_max and gender to each creator record and group the database into age bands for reporting and planning.
- Balance a creator roster: Check the age and gender mix of a planned roster before launch and adjust it when one group is over-represented.
Age and Gender Detection API Pro Tips
- Run the Age and Gender Detection API on personal accounts with a clear headshot, where one visible face gives the most reliable age and gender estimate.
- Set a minimum gender_confidence before using gender in automatic filters, and leave lower scores for review.
- Treat the estimate as a range and compare creators by whether age_min and age_max overlap your target band.
Related APIs
Beyond the Age and Gender Detection API, use these APIs when you need a different type of public Creator data.
- Influencer Email Finder API — Find a creator's public business emails from one Instagram, TikTok, YouTube, X or Facebook profile, each listed with the pages where it was found.
- Social Media Profile Finder API — Find the accounts a creator runs on other networks from one profile URL, each with a confidence from 0 to 1 and the evidence behind the match.