API reference / Age & gender / Age & gender image analysis

Age & gender image analysis

Analyze a non-empty batch of publicly accessible image URLs and return age and gender estimates.

1 credit per successful call Errors are never charged

Request

GET https://socialgraph.dev/api/v1/age-gender/analyze/batch/download

Send your API key as Authorization: Bearer YOUR_API_KEY. Parameters go in the query string.

Parameters

Name	Type	Description
`image_urls` required	array max 10 items	Up to 10 publicly accessible HTTPS image URLs.

Code examples

Example response

[
    {
        "url": "https://example.com/photo-with-face.jpg",
        "result": {
            "age": 55,
            "gender": "Man",
            "face_confidence": 0.8426
        }
    },
    {
        "url": "https://example.com/photo-without-face.png",
        "result": null
    },
    {
        "url": "https://example.com/missing.jpg",
        "error": "Failed to download https://example.com/missing.jpg: HTTP 404",
        "status_code": 400
    }
]

Errors

Status	Meaning	Charged?
401	Missing, invalid or revoked API key	No
402	Not enough credits (`insufficient_credits`)	No
404	The account or post doesn't exist	No
422	Missing or invalid parameters	No
502 / 503	The data source is temporarily unavailable	No

All error codes →

Try it live: Age & gender image analysis GET

image_urls

🔒 Preset demo input. The live demo analyses a public-domain portrait of Abraham Lincoln (1863). Sign up free to use your own.