creator/
age-gender

The Age and Gender Detection API estimates a creator's age range and gender from the face in their Instagram, TikTok, YouTube, X or Threads profile photo and returns a confidence score for the gender estimate.

Age and Gender Detection API

One profile URL
Age range
Gender with confidence
Five networks
1 credit / request
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

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

ParametersRequiredDescription
urlRequiredOne 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.

  1. POST {"url": "https://x.com/levelsio"} to /v1/creator/age-gender.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. 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.

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.

Explore other platforms

Combine Creator data with public data from other supported social platforms.

Age and Gender Detection API — FAQ

Age and Gender Detection API is a programmatic interface that estimates a creator's age range and gender from the face in their profile photo. It works with Instagram, TikTok, YouTube, X and Threads profiles and adds a confidence score to the gender estimate.

The face in the profile photo is analyzed to produce an age range in years and a gender, with gender_confidence from 0 to 100 showing how certain the gender estimate is.

Personal accounts whose profile photo shows one clear face. The estimate is read from that face, and every row also carries the network and username so you can match it back.

Send one Instagram, TikTok, YouTube, X or Threads profile URL per request.

The Age and Gender Detection API charges 1 credit per lookup and returns one row. A profile that does not exist fails and is fully refunded.