guide
Implementing the Get Age Category API
Check out the Meta Horizon Channel
For more on this topic, take the Course: Completing Age Group Self-Certification
In partnership with
2 min read2 min read
Share this doc:
If your app is intended for mixed ages (children aged 10-12 and people aged 13+), you are required to implement the Get Age Category API.
Level of effort:
Skill Required:
Beginner to intermediate
Estimated Time to Implement:
2-4 hours
What is it?
Meta's Get Age Category API allows you to receive your users' age group from Meta.
You ARE required to...
Implement the Meta-provided Get Age Category API within 30 days of age group self-certification
You are NOT required to...
Undergo an additional review; Meta will confirm the data is flowing as expected, but will not conduct any additional review for this implementation
When you implement the Get Age Category API, it is your responsibility to make sure users are seeing content that is appropriate to their age group.
How long will it take?
Time required to implement and test will vary app-to-app, but we estimate it will only take you a few hours to complete. It will require a code integration, but you will not need to write any new, custom code. This implementation does not require advanced skills.
You can update your age group at any time as your app evolves. If your audience expands to include both teens and adults aged 13+ and children younger than 13, change your self-certified age group in the Developer Dashboard and complete this simple implementation within 30 days.
When should I make the API call?
Meta recommends you use the API once every session, i.e. every time a user enters the app.
Why am I required to implement this API?
Meta uses a variety of data points to estimate user age in case those users are an age different than stated in their account. If Meta believes that a user may not be in the right account for their age based on the signal received from a developer, then Meta will help the user migrate to the correct age appropriate account.
This integration does NOT give Meta access to any new data. It only facilitates the passing of user age group information to and from Meta to detect discrepancies.
Documentation:
Disclaimer: This resource does not guarantee compliance with Meta policies, nor applicable data privacy laws. Review Meta Horizon's Developer Data Use Policy for a comprehensive overview of Meta's requirements.