Facebook continues to make real-time improvements to its platform to protect people's data. We are making the following changes to maintain trust with people who use our products. These changes are never easy, but by focusing our efforts, we can put stronger protections in place to combat potential abuse. Please find a quick summary of these changes below:
- App review required to ask users to share checkins, likes, photos, videos, events, and groups
- Following fields are now deprecated and will return empty data:
relationship_status
,religion
,political
,friendlists
,education
,work
,about
,website
,interested_in
- Following Open Graph permissions are also deprecated and will return empty data:
books
,fitness
,games
,music
,news
,video
- Taggable friends and mutual friends APIs are now deprecated
- App review required
- Page conversations will receive a new thread identifier
- Require a Page access token with a matching Page for specific endpoints:
/agencies
,/canvases
,/instagram_accounts
,/leadgen_forms
,/page_backed_instagram_accounts
,/promotable_posts
,/page/userpermissions
- Deprecated
/checkin_posts
API and webhook - Remove social context elements:
/friends_who_like
,/friends_tagged_at
,/video_watch_friends
,/music_listen_friends
- App review required to use the following edges:
GET /page/events
andGET /me/events
- App review required
- Deprecated content edges on all events:
/feed
,/posts
,/comments
,/pictures
,/videos
,/live_videos
,/photos
- Deprecated user edges on all events:
/attending
,/interested
,/declined
,/maybe
,/noreply
- See User Node and Page API sections for details of /events edges on these nodes
- App review required; API use must meet a specific group admin need
- Removed some fields returned by edges on groups:
to
,from
,likes
,reactions
,name_tags
,message_tags
,with_tags
,tags
,admin_creator
- Deprecated APIs that share data about people in groups, including
/members
,/admins
,/owner
and a number of undocumented endpoints:/member_requests
,/moderators
,/former_members
,/insights
,/links
,/tagged
- Deprecated Search API for pages, groups, events, and users
- Updated Instant Games
context_fetchPlayers API
to limit users returned to those who have played in the specified context - Deprecated Scores API, Achievements API,
/taggable_friends
, and/invitable_friends
- Deprecated
/{app-id}/staticresources
- Removed age, gender and country information from the app_event metric
- Instagram is accelerating the previously announced deprecation of the Instagram API Platform and has lowered rate limits
- The following User node fields will no longer return information:
about
,education
,friendlists
,interested_in
,political
,relationship_status
,religion
,website
,work
. GET /user/groups
andGET /me/groups
- This edge no longer returns any fields that contain User identifying information. This applies to all app Users, even app Admins querying their own User ID.- App review required to use the following edges:
GET /user/events
andGET /me/events
(apps withuser_events
permission granted will still require re-review)
/me?fields=relationship_status,political,friendlists,religion,education,work,about,website
{
"id": {user-id}
}
/{page-id}?fields=context
{
"id": "<sanitized>"
}
/{event-id}/feed
/{event-id}/posts
/{event-id}/comments
/{event-id}/pictures
/{event-id}/videos
/{event-id}/live_videos
/{event-id}/photos
/{event-id}/attending
/{event-id}/interested
/{event-id}/declined
/{event-id}/maybe
/{event-id}/noreply
{
"data": []
}
/{group_id}/members
/{group_id}/admins
/{group_id}/owner
{
"data": [],
"paging": {
"cursors": {
"before": "<sanitized>",
"after": "<sanitized>"
}
}
}
/search?type=page&q=chocolate
{
"error": {
"code": 1,
"error_subcode": 1357045,
"message": "unknown error (empty response)",
"type": "http",
"status": 0
}
}
/{user-id}/score
/{user-id}/scores
/{app-id}/scores
{
"error": {
"message": "(#11) This endpoint has been deprecated.",
"type": "OAuthException",
"code": 11,
"fbtrace_id": "<sanitized>"
}
}
/{user-id}/achievements
/{app-id}/achievements
{
"data": []
}
/{user-id}/taggable_friends
/{user-id}/invitable_friends
{
"data": []
}
/{app-id}/staticresources
{
"error": {
"message": "(#100) Tried accessing nonexisting field (staticresources) on node type (Application)",
"type": "OAuthException",
"code": 100,
"fbtrace_id": "<sanitized>"
}
}
/{app-id}/app_insights/app_event/?aggregateBy=SUM&event_name=fb_ad_network_revenue&breakdowns=['age']
/{app-id}/app_insights/app_event/?aggregateBy=SUM&event_name=fb_ad_network_revenue&breakdowns=['gender']
/{app-id}/app_insights/app_event/?aggregateBy=SUM&event_name=fb_ad_network_revenue&breakdowns=['country']
{
"error": {
"message": "(#3011) Currently unavailable",
"type": "OAuthException",
"code": 3011,
"fbtrace_id": "<sanitized>"
}
}
We never make these platform changes lightly, but at the same time, there's nothing more important to us than privacy and security. We know these changes are not easy and we regret any disruption caused, but we believe these updates will help strengthen trust in our broader developer ecosystem.
For more information about the products affected and some of the reasoning behind these changes, please follow the latest updates on Facebook Developers blog (https://developers.facebook.com/blog/) and the breaking changes doc (https://developers.facebook.com/docs/graph-api/changelog/breaking-changes#4-4-2018).
Please direct any questions below and we will get back to you as soon as possible. For more general or implementation questions regarding the Facebook platform, please visit the Facebook Developer Community Group: https://www.facebook.com/groups/fbdevelopers/.
Facebook would like to thank you and the entire global developer community for working with us to create a better experience for people.
Thank you,
Facebook Developer Support Engineering