# Utility Age Gender API (https://www.socialcrawl.dev/platforms/utility/age-gender)

> Uses AI to detect the estimated age and gender of a person from their social profile picture. Returns an age range, gender, and confidence scores.

TL;DR: `GET /v1/utility/age-gender` costs 10 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Social profile URL whose avatar should be analyzed (e.g. a Twitter/X profile URL) |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/utility/age-gender?url=https%3A%2F%2Ftwitter.com%2Flevelsio" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How does the age and gender detection API work?

Send a GET request to /v1/utility/age-gender with the url parameter set to a direct image URL. SocialCrawl's AI analyzes the face and returns the estimated age, predicted gender, and a confidence score as structured JSON — one call, no ML setup.

### What does the age-gender endpoint return?

The response contains an age estimate, a gender prediction, and a confidence score that tells you how certain the model is. The confidence score lets you set your own threshold — keep high-confidence results, re-check or discard low-confidence ones.

### How accurate is the age and gender estimate?

Accuracy depends on the photo: a clear, front-facing, well-lit face produces the most confident estimates, while small, blurred, or partially covered faces lower the confidence score. Treat the output as a statistical estimate and use the confidence score to filter, not as a verified fact.

### How much does one age-gender detection cost?

Each request costs 10 credits on the premium tier. New accounts get 100 free credits with no credit card required, so you can run 10 detections before paying anything.

### Can I analyze social media profile pictures with this endpoint?

Yes — that is its main job at SocialCrawl. Pull avatar URLs with the profile endpoints for TikTok, Instagram, X, or any of the other platforms, then pass each avatar URL to /v1/utility/age-gender to estimate creator or audience demographics at scale.

### Does the endpoint identify who is in the photo?

No. It returns statistical estimates — age range, gender, confidence — not identity matches, face embeddings, or recognition against any database. You remain responsible for complying with biometric and privacy laws that apply to your use case.

See the full Utility API: https://www.socialcrawl.dev/platforms/utility

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to detect age and gender from an image URL with an API
- What does the SocialCrawl age-gender endpoint return?