0

Facebook API Changes (v2.3 Deprecated)

Hey everyone!

Just a heads up that Facebook is deprecating v2.3 of their Graph API on July 8th. We encourage you to update to the current version v2.9. However, we will be performing our migration to v2.4 to support your existing data sources on July 6th.

For example your query will change from:

graph.facebook.com/v2.3/me       to

graph.facebook.com/v2.4/me  

 

There are some things that we are unable to update for you and may need action on your part.

Note: These changes do not affect data sources using the Facebook Marketing API.

 

If you are still using API v2.3 please check out Facebook's Platform Changelog for more information.

What should I know?

  • Nodes in the Graph API will return fewer fields by default. Fields need to be explicitly requested using the 'fields' parameter. Fields not requested will not be included in the response. For more help on this check out Facebook's doc.  
    For example:
    GET /v2.4/me/feed no longer includes likes and comments by default, to receive those fields you must use GET /v2.4/me/feed?fields=comments,likes.

 

  • The Page Insights Metric page_story_adds_by_story_type has been deprecated.

 

  • The 'global_brand_parent_page' field on Page node will no longer be available to reflect changes to Global Pages structure. Instead use 'global_brand_root_id' field to fetch and manage the Global Pages children pages and Location pages of that hierarchy.
    For example:
    GET {global-brand-root-id}/global_brand_children
    GET and POST {global-brand-root-id}/locations.

 

  • The maximum limit for Page related objects is now set to limit=100 (previously 250). This will impact GET operations made on the feed, posts, and promotable_posts edges.

 

  • A page access token will now be required for the 'admin_creator' field from GET {post_id}.

Finally, after July 6th please double-check that any Klips using Facebook data sources work as expected.

Let us know if you have any questions, we are here to help!

1 comment

  • 0
    Avatar
    Natalia Castillo

    Hi everyone!

    Like mentioned above, nodes in the Graph API will return fewer fields by default in version 2.4 and up. Here's an example of how you should modify your queries to ensure everything works as it did in version 2.3.

    Say I am using the /posts node to retrieve my Facebook Posts. 

    • v2.3 returns ALL fields by default.
    https://graph.facebook.com/v2.3/<yourPageId>/posts
    • v2.4 only returns fields specified. So I've added ?fields=message,picture,link,name to my query.
    https://graph.facebook.com/v2.4/<yourPageId>/posts?fields=message,picture,link,name

     

    For a list of fields available for each node, visit the Facebook API reference.

     

    Hope that helps!

Please sign in to leave a comment.