Content Library and API

Meta Content Library API

Version v5.0

Use Meta Content Library API to query and analyze the Meta public content archive. Conduct data analysis in Python or R using Meta's Researcher Platform, a secure digital cleanroom. The API can also be used in an approved third-party cleanroom. Each third-party cleanroom environment has its own user interface, the documentation of which is outside the scope of Meta Content Library and API documentation.

The Content Library API provides access to near real-time public Facebook and Instagram data:

  • Facebook public Pages
  • Facebook public groups
  • Facebook public events
  • Facebook public profiles
  • Facebook posts from Facebook public Pages, profiles, groups and events
  • Facebook public comments
  • Instagram public creator, business and personal accounts
  • Instagram posts from Instagram public creator, business and a subset of personal accounts
  • Instagram public comments

Facebook profiles must be set to public and have either a verified badge or a threshold number of followers to be included. A verified badge in this context refers to accounts confirmed as authentic and not those with a paid Meta Verified subscription. Learn more about verified Pages and profiles. See Guide to Facebook profiles data for the threshold number followers by API version.

Public Instagram accounts include professional accounts for businesses and creators. They also include a subset of personal accounts that meet qualification criteria, including account privacy set to public and either a verified badge or a threshold number of followers. A verified badge in this context refers to accounts confirmed as authentic and not those with a paid Meta Verified subscription. See Guide to Instagram accounts data for the threshold number of followers by API version.

If you want to explore the Content Library data in a web-based user interface, try Meta Content Library.

In code block examples in this documentation, select the R or Python tab to see the corresponding code. You can copy and paste the code.

Documentation contents

Overview

Introduction to the Meta Content Library API, its relationship to Meta Content Library, important core concepts, and an overview of the documentation we provide.

Getting started

Instructions for getting up and running quickly. If you're ready to try out the API, this is the place to start.

Guides

An in-depth guide for each endpoint plus additional topics to enhance your user experience.

Support

Information regarding the Meta Content Library and API tools and data in FAQ format plus a review of the measures Meta uses for monitoring search quality including known limitations to search functionality and performance.

Appendix

Reference material including a detailed data dictionary.

Learn More