Meta Content Library API

Version v3.0

Use the Meta Content Library API to query and analyze Meta's full historical 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, 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

Note that 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 25,000 or more followers. A verified badge in this context refers to accounts confirmed as authentic and not those with a paid Meta Verified subscription.

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.