Skip to main content
POST
Age and Gender Detection API

Age and Gender Detection

Sort a creator list by demographic before you spend time reviewing content. The estimate is read from the face in the profile photo and comes back as an age range, a gender and a confidence score. It works best on personal accounts with a clear headshot; logos and group photos leave the age and gender fields empty.
Provide one Instagram, TikTok, YouTube, X or Threads profile URL in url. Age and gender are estimated from the face in the profile photo. Each lookup costs 1 credit and returns one row. A profile that does not exist fails with a refund.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide one Instagram, TikTok, YouTube, X or Threads profile URL in url. Age and gender are estimated from the face in the profile photo, which suits accounts run by a person.

url
string
required
Minimum string length: 1
callback_url
string<uri>

Response

Task accepted

code
integer
data
object