Data dictionary
This data dictionary describes the data names displayed in the Meta Content Library web UI (the Name column) if applicable, and the corresponding API fields returned in Meta Content Library API search responses (the API field column). In the API field column, some fields have nested fields indicated by a dot notation. These are referred to as expanded fields. See Field expansion for information about how to include some or all of a parent field's expanded fields in your queries.
Public data available in Meta Content Library and API
Facebook—view-only public data (not downloadable)
Data includes the following publicly accessible content:
- Posts on public Pages, public groups, and public events
- Posts on public profiles with a verified badge or 1,000 or more followers
- Information about public Pages, public groups, public events and public profiles that meet the above criteria
Facebook—downloadable public data (from widely-known individuals and organizations)
The functionality to download the public data subset is only available in the Content Library user interface (not in the API), and only if the Inter-university Consortium for Political and Social Research (ICPSR) has approved your Meta Content Library application and you or your institution has consented to the appropriate contract terms (Product Terms for Meta Research Tools, Information Sharing Agreement). Data includes the following publicly accessible content:
Posts from public Pages with 15,000 or more likes or 15,000 or more followers
Posts from public profiles with a verified badge or 25,000 or more followers
Information about public Pages and public profiles that meet the above criteria
Public Pages include both classic Pages and the new Pages experience.
To be included in the downloadable public dataset, profiles must not be locked and must be set to public with 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. Learn more about verified Pages and profiles.
Downloadable public data consists of posts from eligible profiles and Pages to all surfaces, including groups, events and Pages.
Instagram—view-only public data (not downloadable)
Data includes the following publicly accessible content:
- Posts from public business accounts and public creator accounts
- Posts from personal accounts set to public with 1,000 or more followers
- Information about public Instagram accounts that meet the above criteria
Instagram—downloadable public data (from widely-known individuals and organizations)
The functionality to download the public data subset is only available in the Content Library user interface (not in the API), and only if ICPSR has approved your Meta Content Library application and you or your institution has consented to the appropriate contract terms (Product Terms for Meta Research Tools, Information Sharing Agreement). Data includes the following publicly accessible content:
- Posts from public business and creator accounts with a verified badge or 25,000 or more followers
- Posts from personal accounts set to public with a verified badge or 25,000 or more followers
- Information about public Instagram accounts that meet the criteria above
Public Instagram accounts include professional accounts for businesses and creators. They also include personal accounts that meet the qualification criteria outlined above.
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 badges.
Threads (UI only—Not available in the Content Library API)
Data includes the following publicly accessible content:
Posts shared by public profiles with 1,000 or more followers
Information about public profiles
Note: Threads content is a newly added data type in Meta Content Library. Data quality may have significant variation as the dataset is still in active development. Threads content is not available for download while this dataset is in development.
Facebook Page
| Name | API field | Description | Products |
|---|---|---|---|
Meta Content Library ID | id | Unique ID linked to a Facebook Page; cannot be used to search on Meta technologies. | Content Library API |
Name | name | The name of the Facebook Page. | Content Library Content Library API |
Username | username | The username of the Facebook Page, if available. | Content Library API |
About | about | The short paragraph from the Facebook Page About section. | Content Library Content Library API |
Website | website | The external URL from the Facebook Page About section. | Content Library API |
Description | description | The long paragraph from the Facebook Page About section. | Content Library Content Library API |
Verification status | verification_status | The verification status of the Facebook Page. A Facebook Page with a verified badge indicates that Facebook has confirmed that it is the authentic presence for that person or brand. Learn more about verified Pages and profiles. | Content Library Content Library API |
Page categories | page_categories | The list of up to three categories of the Facebook Page, selected by the Page manager. | Content Library Content Library API |
Location city | location.city | The self-reported, publicly accessible city location associated with the Facebook Page. | Content Library API |
Location country | location.country | The self-reported, publicly accessible country location associated with the Facebook Page. | Content Library API |
Location country code | location.country_code | The self-reported, publicly accessible country code location associated with the Facebook Page. | Content Library API |
Location name | location.name | The self-reported, publicly accessible location name associated with the Facebook Page. | Content Library API |
Location region | location.region | The self-reported, publicly accessible region location associated with the Facebook Page. | Content Library API |
Location zip | location.zip | The self-reported, publicly accessible location zip associated with the Facebook Page. | Content Library API |
Location street | location.street | The self-reported, publicly accessible street location associated with the Facebook Page. | Content Library API |
Location state | location.state | The self-reported, publicly accessible state location associated with the Facebook Page. | Content Library API |
Page name change date | page_transparency.page_name_changes.data.date | The date of Facebook Page name change. | Content Library API |
Page name old | page_transparency.page_name_changes.data.old_name | The old name of the Facebook Page prior to the name change. | Content Library API |
Page name new | page_transparency.page_name_changes.data.new_name | The new name of the Facebook Page, following the name change. | Content Library API |
Page merged date | page_transparency.page_merges.data.date | The date another Facebook Page merged with this Page. | Content Library API |
Page merged | page_transparency.page_merges.data.page_merged | The name of the Facebook Page that merged with this Page. | Content Library API |
Creation date | creation_date | The date the Facebook Page was created. | Content Library Content Library API |
Page manager countries | page_transparency.admin_countries.data.country | The predicted primary country locations of people who manage this Facebook Page. | Content Library Content Library API |
Count of Page managers by countries | page_transparency.admin_countries.data.count | The number of people who manage this Facebook Page predicted to be from the associated country. | Content Library Content Library API |
Page owner | page_transparency.confirmed_page_owner | The confirmed owner associated with the Facebook Page. | Content Library API |
Has active ads | page_transparency.has_active_ads | Whether the Facebook Page has active ads or not. | Content Library API |
Has run political ads | page_transparency.has_run_political_ads | Whether the Facebook Page has run political ads or not. | Content Library API |
Followers | follower_count | The number of followers of the Facebook Page. | Content Library Content Library API |
Page likes | like_count | The number of likes of the Facebook Page. | Content Library API |
Facebook group
| Name | API field | Description | Products |
|---|---|---|---|
Meta Content Library ID | id | Unique ID linked to a Facebook group; cannot be used to search on Meta technologies. | Content Library API |
Name | name | The name of the Facebook group. | Content Library Content Library API |
Username | username | The username of the Facebook Page, if available and group meets eligible criteria. | Content Library API |
Description | description | The description of the Facebook group. | Content Library Content Library API |
Creation date | creation_date | The date the Facebook group was created. | Content Library Content Library API |
Group original name | group_transparency.original_name | The original name of the Facebook group. | Content Library API |
Group name change date | group_transparency.name_changes.data.date | The date the name of the Facebook group changed. | Content Library Content Library API |
Group name new | group_transparency.name_changes.data.new_name | The new name of the Facebook group. | Content Library API |
Group admin and moderator Page Meta Content Library IDs | group_transparency.admin_and_moderator_page_ids | The list of Unique IDs linked to the Facebook Pages that are admins or moderators of the Facebook group. These unique IDs cannot be used to search on Meta technologies. | Content Library API |
Group owner type | group_owners.data.type | The type of the group owner associated with the Facebook group.This field will display if the group owner is a professional profile or Page. | Content Library API |
Group owner Meta Content Library ID | group_owners.data.id | Unique ID of the Facebook group owners. This field will display if the group owner is a professional profile or Page. | Content Library API |
Picture URL | picture_url | The photo URL of the Facebook group. | Content Library API |
Group members | member_count | The number of members of the Facebook group. | Content Library Content Library API |
Facebook event
| Name | API field | Description | Products |
|---|---|---|---|
Meta Content Library ID | id | Unique ID linked to a Facebook event; cannot be used to search on Meta technologies. | Content Library API |
Name | name | The name of the Facebook event. | Content Library Content Library API |
Description | description | The description of the Facebook event. | Content Library Content Library API |
Creation time | creation_time | The time the Facebook event was created. | Content Library API |
Event start time | event_start_time | The start time of the Facebook event. Not available if the event is the parent of recurring event instances. Learn more about recurring events. | Content Library Content Library API |
Event end time | event_end_time | The end time of the Facebook event. Not available if the event is the parent of recurring event instances. Learn more about recurring events. | Content Library API |
Going responses | going_count | The number of Going responses on a Facebook event. Not available if the event is the parent of recurring event instances. Learn more about recurring events. | Content Library Content Library API |
Interested responses | interested_count | The number of Interested responses on a Facebook event. Not available if the event is the parent of recurring event instances. Learn more about recurring events. | Content Library Content Library API |
Event type | event_type | The type of Facebook event. Event types include single instance, recurring or instance of recurring. | Content Library API |
Recurring event Meta Content Library IDs | recurring_event_ids | The list of unique Meta Content Library IDs of the recurring instances of the Facebook event, if the event is recurring; these unique IDs cannot be used to search on Meta technologies. Only available if the event is the parent of recurring event instances. Learn more about recurring events. | Content Library API |
Parent event ID | parent_event_id | The unique ID of the parent event of the Facebook event, if the event is recurring; cannot be used to search on Meta technologies. Only available if the event is an instance of a recurring event. Learn more about recurring events. | Content Library API |
Event owners type | event_owners.data.type | The type of the event owner associated with the Facebook event. | Content Library API |
Event owners Meta Content Library ID | event_owners.data.id | The unique ID of the event owner associated with the Facebook event; cannot be used to search on Meta technologies. This field will display if the event owner is a group, professional profile or Page. For events owned by professional profiles or Pages, only the Meta Content Library Page ID will be shared. | Content Library API |
Place name | place.name | The self-reported, publicly accessible name of the place where the Facebook event is located. | Content Library API |
Place location city | place.location.city | The self-reported, publicly accessible city where the Facebook event is located. | Content Library API |
Place location country | place.location.country | The self-reported, publicly accessible country where the Facebook event is located. | Content Library API |
Place location country code | place.location.country_code | The self-reported, publicly accessible country code of the Facebook event’s location. | Content Library API |
Place location name | place.location.name | The self-reported, publicly accessible name of the Facebook event’s location. | Content Library API |
Place location region | place.location.region | The self-reported, publicly accessible region where the Facebook event is located. | Content Library API |
Place location state | place.location.state | The self-reported, publicly accessible state where the Facebook event is located. | Content Library API |
Place location street | place.location.street | The self-reported, publicly accessible street where the Facebook event is located. | Content Library API |
Place location zip | place.location.zip | The self-reported, publicly accessible zip of the Facebook event’s location. | Content Library API |
Facebook profile
| Name | API field | Description | Products |
|---|---|---|---|
Meta Content Library ID | id | Unique ID linked to a Facebook profile; cannot be used to search on Meta technologies. | Content Library API |
Name | name | The name of the Facebook profile, if user meets eligibility criteria. | Content Library Content Library API |
Username | username | The username of the Facebook Page, if available and user meets eligibility criteria. | Content Library API |
About | about | Text of the 'About' section. | Content Library Content Library API |
Follower count | follower_count | The number of followers of the Facebook profile. | Content Library Content Library API |
Intro | intro | Text of intro. | Content Library Content Library API |
Verification status | verification_status | Verification status. Possible values: not_verified and blue_verified. | Content Library Content Library API |
Creation date | creation_date | The date the Facebook profile was created. | Content Library Content Library API |
Profile categories | profile_categories | The list of up to three categories of the Facebook profile, selected by the profile owner. | Content Library Content Library API |
Admin countries | profile_transparency.admin_countries | List of predicted primary country locations of the Facebook profile owner. | Content Library Content Library API |
Has active ads | profile_transparency.has_active_ads | Whether the Facebook profile has active ads or not. | Content Library Content Library API |
Picture height | picture.height | Height of the photo URL of the Facebook profile. | Content Library Content Library API |
Picture URL | picture.url | The photo URL of the Facebook profile. | Content Library Content Library API |
Picture width | picture.width | Width of the photo URL of the Facebook profile. | Content Library Content Library API |
Websites | websites | The external URLs from the Facebook profile’s 'About' section. | Content Library Content Library API |
Facebook post
| Name | API field | Description | Products |
|---|---|---|---|
Meta Content Library ID | id | Unique ID linked to a Facebook post; cannot be used to search on Meta technologies. | Content Library API |
Text | text | The text of the Facebook post. Tags are excluded. Not applicable to stories. | Content Library Content Library API |
Match type | match_type | List of match types for text searches in text, images and stories. Match types include:
| Content Library Content Library API |
Activity type | activities.type | Type of activity represented in a post. Activity types include | Content Library Content Library API |
Activity name | activities.name | Name of the activity represented in a post. For example, if the activity type is | Content Library Content Library API |
Creation time | creation_time | The time the Facebook post was created. | Content Library Content Library API |
Modified time | modified_time | The time the Facebook post was most recently modified. | Content Library API |
Language | lang | The content language of the Facebook post. Returns ISO 639-1 language code in 2-letter lowercase format. | Content Library (Filter only) Content Library API |
Likes | statistics.like_count | The number of like reactions on the post. Not applicable to stories. | Content Library Content Library API |
Love reactions | statistics.love_count | The number of love reactions on the post. Not applicable to stories. | Content Library Content Library API |
Wow reactions | statistics.wow_count | The number of wow reactions on the post. Not applicable to stories. | Content Library Content Library API |
Haha reactions | statistics.haha_count | The number of haha reactions on the post. Not applicable to stories. | Content Library Content Library API |
Sad reactions | statistics.sad_count | The number of sad reactions on the post. Not applicable to stories. | Content Library Content Library API |
Angry reactions | statistics.angry_count | The number of angry reactions on the post. Not applicable to stories. | Content Library Content Library API |
Comments | statistics.comment_count | The number of comments on the post. Not applicable to stories. | Content Library Content Library API |
Reactions | statistics.reaction_count | The total number of reactions on the post. Reactions include: Like, Love, Care, Haha, Wow, Sad or Angry. Not applicable to stories. | Content Library Content Library API |
Shares | statistics.share_count | The number of times the post was shared. Not applicable to stories. | Content Library Content Library API |
Care reactions | statistics.care_count | The number of care reactions on the post. Not applicable to stories. | Content Library Content Library API |
Views | statistics.views | Number of times the post was on screen, not including times it appeared on the post owner’s screen. For video posts, views are counted whether the video was played or not. Only posts with more than 100 views display the view count. A post displays no view count value if there were fewer than 100 views as of the last refresh. View counts for posts created within the last 180 days are refreshed approximately every 24 hours, provided the post has accumulated more than 10 views within that 24 hour period. If not, view counts are refreshed every 5-7 days. View counts for posts created more than 180 days ago are refreshed every 5-7 days. View counts are not available for posts created before January 1, 2017. | Content Library Content Library API |
View counts last refreshed date | view_date_last_refreshed | The date the view count was last refreshed. See Views definition for refresh schedule. | Content Library Content Library API |
Post owner type | post_owner.data.type | The type of post owner associated with the Facebook post. Post owner types include: Pages and profiles. | Content Library Content Library API |
Post owner Meta Content Library ID | post_owner.data.id | Unique ID linked to the owner associated with the Facebook post. These unique IDs cannot be used to search on Meta technologies. | Content Library API |
Post owner name | post_owner.data.name | The name of the post owner associated with the Facebook post, if post owner meets eligibility criteria. | Content Library Content Library API |
Post owner username | post_owner.data.username | The username of the post owner associated with the Facebook post, if available and post owner meets eligibility criteria. | Content Library API |
Post surface type | surface.type | The type of surface of the Facebook post. Post surface types include: Pages, profiles, groups and events. | Content Library Content Library API |
Post surface Meta Content Library ID | surface.id | Unique ID linked to the surface of the Facebook post. These unique IDs cannot be used to search on Meta technologies. | Content Library API |
Post surface name | surface.name | The name of the surface of the Facebook post, if user meets the eligibility criteria. | Content Library Content Library API |
Media type (deprecated as of version 5.0) | media_type | The media type included in the Facebook Post. Media types include photos, videos, albums, links, status and reshares. | Content Library API |
Content type | content_type | The content type included in the Facebook post. Content types include photos, albums, videos (including gaming videos) and reels, stories and miscellaneous (including links, reshares and text-only posts). | Content Library |
Content type | content_type | The content type included in the Facebook post. Content types include photos, videos (including gaming videos), albums, stories, links, status and reshares. | Content Library API |
Branded content Page Meta Content Library ID | branded_content_page_id | Unique ID linked to the Page associated with the Facebook post; cannot be used to search on Meta technologies. Included if the post has branded content. Learn more about branded content | Content Library API |
Is branded content | is_branded_content | Whether the Facebook post has branded content or not. Learn more about branded content | Content Library API |
Link attachment fields description | link_attachment_fields.description | The description of the link attachment included in the Facebook post. Not applicable to stories. | Content Library API |
Link attachment fields link | link_attachment_fields.link | The URL of the link attachment included in the Facebook post. Not applicable to stories. | Content Library API |
Link attachment fields name | link_attachment_fields.name | The name of the link attachment included in the Facebook post. Not applicable to stories. | Content Library API |
Link attachment fields caption | link_attachment_fields.caption | The caption of the link attachment included in the Facebook post. Not applicable to stories. | Content Library API |
Shared post Meta Content Library ID | shared_post_id | Unique ID linked to the reshared post included in the Facebook post; cannot be used to search on Meta technologies. | Content Library API |
Facebook post third-party cleanroom only
The following data dictionary entries are only available when using the Content Library API in an approved third-party cleanroom that supports the specific functionality.
| Name | API field | Description | Products |
|---|---|---|---|
Multimedia type | multimedia.type | The type (photo or video) of the multimedia content. | Content Library API |
Multimedia Meta Content Library ID | multimedia.id | Unique ID linked to the photo or video content. These unique IDs cannot be used to search on Meta technologies. | Content Library API |
Multimedia URL | multimedia.url | URL within a storage location to which the multimedia content has been downloaded by the third-party cleanroom if the cleanroom system is unable to provide the multimedia directly in the search results. | Content Library API |
Facebook comment
| Name | API field | Description | Products |
|---|---|---|---|
Meta Content Library ID | id | Unique ID linked to a Facebook comment; cannot be used to search on Meta technologies. | Content Library API |
Owner ID | owner.id | Unique ID linked to the owner associated with the Facebook comment; cannot be used to search on Meta technologies. | Content Library API |
Owner type | owner.type | The type of comment owner associated with the Facebook comment. Comment owner types include: page, profile and private. | Content Library API |
Owner username | owner.username | The username of the comment owner associated with the Facebook comment, if available and user meets the eligibility criteria. | Content Library API |
Owner name | owner.name | The name of the comment owner associated with the Facebook comment. if user meets the eligibility criteria. | Content Library API |
Post ID | post_id | Unique ID linked to a Facebook comment; cannot be used to search on Meta technologies. | Content Library API |
Parent Comment Meta Content Library ID | parent_comment_id | Unique ID associated with the Facebook comment, that the comment was shared as a reply; cannot be used to search on Meta technologies. Non-existing field if comment has no parent comment. | Content Library API |
Text | text | The text of the Facebook comment. Tags are excluded. | Content Library API |
Creation time | creation_time | The time the Facebook comment was created. | Content Library API |
Language | lang | The content language of the Facebook comment. Returns ISO 639-1 language code in 2-letter lowercase format. | Content Library API |
Link attachment fields link | link_attachment.url | The URL of the link attachment included in the Facebook comment. | Content Library API |
Link attachment fields name | link_attachment.name | The name of the link attachment included in the Facebook comment. | Content Library API |
Link attachment caption | link_attachment.caption | The caption of the link attachment included in the Facebook comment. | Content Library API |
Link attachment description | link_attachment.description | The description of the link attachment included in the Facebook comment. | Content Library API |
Likes | statistics.like_count | The number of like reactions on the comment. | Content Library API |
Love reactions | statistics.love_count | The number of love reactions on the comment. | Content Library API |
Wow reactions | statistics.wow_count | The number of wow reactions on the comment. | Content Library API |
Haha reactions | statistics.haha_count | The number of haha reactions on the comment. | Content Library API |
Sad reactions | statistics.sad_count | The number of sad reactions on the comment. | Content Library API |
Angry reactions | statistics.angry_count | The number of angry reactions on the comment. | Content Library API |
Care reactions | statistics.care_count | The number of care reactions on the comment. | Content Library API |
Reaction count | statistics.reaction_count | The total number of reactions on the comment. Reactions include Like, Love, Care, Haha, Wow, Sad or Angry. | Content Library API |
Comment count | statistics.comment_count | The total number of all replies to a comment. | Content Library API |
Top-level reply count | statistics.top_level_reply_count | The total number of top-level replies of a comment. | Content Library API |
Facebook comment third-party cleanroom only
The following data dictionary entries are only available when using the Content Library API in an approved third-party cleanroom that supports the specific functionality.
| Name | API field | Description | Products |
|---|---|---|---|
Multimedia type | multimedia.type | The type (photo or video) of the multimedia content. | Content Library API |
Multimedia Meta Content Library ID | multimedia.id | Unique ID linked to the photo or video content. These unique IDs cannot be used to search on Meta technologies. | Content Library API |
Multimedia URL | multimedia.url | URL within a storage location to which the multimedia content has been downloaded by the third-party cleanroom if the cleanroom system is unable to provide the multimedia directly in the search results. | Content Library API |
Instagram account
| Name | API field | Description | Products |
|---|---|---|---|
Meta Content Library ID | id | Unique ID linked to an Instagram account; cannot be used to search on Meta technologies. | Content Library API |
Account type | account_type | The type of public Instagram account. Creator, business and personal accounts are valid types. Public Instagram accounts include professional accounts for businesses and creators. They also include a subset of personal accounts that have privacy set to public and have either a verified badge or 25,000 or more followers (for downloadable public data) or 1,000 or more followers (for view-only data). A verified badge in this context refers to accounts confirmed as authentic and not those with a paid Meta Verified subscription. | Content Library API |
Is verified | is_verified | Whether the Instagram account has a verified badge. A verified badge in this context refers to accounts confirmed as authentic and not to those with a paid Meta Verified subscription. Learn more about verified badges. | Content Library Content Library API |
Followers | follower_count | The number of followers of the Instagram account. | Content Library Content Library API |
Following | following_count | The number of accounts the Instagram account is following. | Content Library API |
Website | website | The external website URL of the Instagram account. | Content Library API |
Username | username | The username of the Instagram account. | Content Library API |
Name | name | The name of the Instagram account, if available. | Content Library Content Library API |
Biography | biography | The description of the Instagram account. | Content Library Content Library API |
Creation date | creation_date | The date the Instagram account was created. | Content Library API |
Instagram post
| Name | API field | Description | Products |
|---|---|---|---|
Meta Content Library ID | id | Unique ID linked to an Instagram post; cannot be used to search on Meta technologies. | Content Library API |
Text | text | The text of the Instagram post. Tags are excluded. Not applicable to stories. | Content Library Content Library API |
Match type | match_type | List of match types for text searches in text, images and stories. Can include one or more of the following match types:
| Content Library Content Library API |
Creation time | creation_time | The time the Instagram post was created. | Content Library Content Library API |
Modified time | modified_time | The time the Instagram post was most recently modified. | Content Library API |
Language | lang | The content language of the Instagram post. Returns ISO 639-1 language code in 2-letter lowercase format. | Content Library API |
Comments | statistics.comment_count | The number of comments on the post. Not applicable to stories. | Content Library Content Library API |
Likes | statistics.like_count | The number of like reactions on the post. Not applicable to stories. | Content Library Content Library API |
Views | statistics.views | Number of times the post was on screen, not including times it appeared on the post owner’s screen. For video posts, views are counted whether the video was played or not. Only posts with more than 100 views display the view count. A post displays no view count value if there were fewer than 100 views as of the last refresh. View counts for posts created within the last 180 days are refreshed approximately every 24 hours, provided the post has accumulated more than 10 views within that 24 hour period. If not, view counts are refreshed every 3-5 days. View counts for posts created more than 180 days ago are refreshed every 3-5 days. View counts are not available for posts made before October 1, 2022. Note that this metric differs from the Views metric displayed on Instagram, which measures the number of times a reel started to play and the number of times a non-reel displayed on a person’s screen. | Content Library Content Library API |
View counts last refreshed date | view_date_last_refreshed | The date the view count was last refreshed. See Views definition for refresh schedule. | Content Library Content Library API |
Post owner account type | post_owner.type | The account type of the post owner associated with the Instagram post. Post owner types include business, creator and personal. For personal accounts, only those with privacy set to public and with either a verified badge or 25,000 or more followers (for downloadable public data) or 1,000 or more followers (for view-only data) are included. A verified badge in this context refers to accounts confirmed as authentic and not those with a paid Meta Verified subscription. | Content Library API |
Post owner Meta Content Library ID | post_owner.id | Unique ID linked to the owner associated with the Instagram post; cannot be used to search on Meta technologies. | Content Library API |
Post owner username | post_owner.username | Username of the owner associated with the Instagram post, if meeting eligibility criteria. | Content Library API |
Post owner Name | post_owner.name | Name of the owner associated with the Instagram post, if available and meeting eligibility criteria. | Content Library Content Library API |
Is branded content | is_branded_content | Whether the Instagram post has branded content or not. Learn more about branded content | Content Library API |
Media type (deprecated as of version 5.0) | media_type | The media type included in the Instagram post. Media types include albums, photos, videos and reels. | Content Library Content Library API |
Content type | content_type | The media type included in the Instagram post. Media types include albums, photos, stories, and videos and reels. | Content Library Content Library API |
Hashtags | hashtags | The list of hashtags included in the Instagram post. Not applicable to stories. | Content Library Content Library API |
Instagram post third-party cleanroom only
The following data dictionary entries are only available when using the Content Library API in an approved third-party cleanroom that supports the specific functionality.
| Name | API field | Description | Products |
|---|---|---|---|
Multimedia type | multimedia.type | The type (photo or video) of the multimedia content. | Content Library API |
Multimedia Meta Content Library ID | multimedia.id | Unique ID associated with the photo or video content; cannot be used to search on Meta technologies. | Content Library API |
Multimedia URL | multimedia.url | URL within a storage location to which the multimedia content has been downloaded by the third-party cleanroom if the cleanroom system is unable to provide the multimedia directly in the search results. | Content Library API |
Instagram comment
| Name | API field | Description | Products |
|---|---|---|---|
Meta Content Library ID | id | Unique ID linked to an Instagram comment. This unique ID cannot be used to search on Meta technologies. | Content Library Content Library API |
Owner ID | owner.id | Unique ID linked to the owner associated with the Instagram comment. This ID cannot be used to search on Meta technologies. | Content Library Content Library API |
Owner type | owner.type | The type of comment owner associated with the Instagram comment. Comment owner types include: creator, business, personal and private. | Content Library API |
Owner username | owner.username | The username of the comment owner associated with the Instagram comment, if user meets the eligibility criteria. | Content Library Content Library API |
Owner name | owner.name | The name of the comment owner associated with the Instagram comment, if available and user meets eligibility criteria. | Content Library Content Library API |
Post ID | post_id | Unique ID linked to an Instagram comment. This ID cannot be used to search on Meta technologies. | Content Library Content Library API |
Parent Comment Meta Content Library ID | parent_comment_id | Unique ID associated with the Instagram comment ifthe comment was shared as a reply; cannot be used to search on Meta technologies. Non existent field if comment has no parent comment. | Content Library Content Library API |
Text | text | The text of the Instagram comment. Tags are excluded. | Content Library Content Library API |
Creation time | creation_time | The time the Instagram comment was created. | Content Library Content Library API |
Language | lang | The content language of the Instagram comment. Returns ISO 639-1 language code in 2-letter lowercase format. | Content Library API |
Link attachment | link_attachment.url | The URL of the link attachment included in the Instagram comment. | Content Library Content Library API |
Likes | statistics.like_count | The number of like reactions on the comment. | Content Library Content Library API |
Comment count | statistics.comment_count | The total number of replies to a comment. | Content Library Content Library API |
Top-level reply count | statistics.top_level_reply_count | The number of top-level replies to a comment. | Content Library API |
Threads post
| Name | API field | Description | Products |
|---|---|---|---|
Likes | N/A | Number of like reactions on the post. | Content Library |
Replies | N/A | Number of replies on the post, including replies to previous replies. Replies on the post can be accessed by clicking the View replies link. This includes replies from all producers who responded to the post. | Content Library |
Reposts | N/A | Number of times the content was reposted. | Content Library |
Views | N/A | Number of times the post was on screen, not including times it appeared on the post owner’s screen. For original posts, view counts include views of the post itself but do not include views of reposts or quotes of the post. For quotes, view counts include views of the quote but do not include views of the original post or reposts. For replies, view counts include views of the reply but do not include views of the original post, quotes or reposts. For video posts, views are counted whether the video was played or not. Only posts with more than 100 views display the view count. A post displays no view count value if there were fewer than 100 views as of the last refresh. View counts for posts created within the last 180 days are refreshed every 24 hours, provided the post has accumulated more than 10 views within a 24 hour period after September 17, 2024. View counts for posts created more than 180 days ago are refreshed every 2 days. View counts are not available for posts created before March 17, 2024. | Content Library |
Post owner | N/A | Original producer of the post. | Content Library |
Post owner name | N/A | Name of the owner associated with the Threads post, if available and meeting eligibility criteria. | Content Library |
Post owner username | N/A | Username of the owner associated with the Threads post, if available and meeting eligibility criteria. | Content Library |
Post date | N/A | Date posted to Threads. | Content Library |
Text | N/A | The text of the Threads post. | Content Library |
Content type | N/A | The content type included in the Threads post. Content types include albums, photos, videos and miscellaneous (including text-only posts and links). | Content Library |
Language | N/A | The content language of the Instagram post. Returns ISO 639-1 language code in 2-letter lowercase format. | Content Library |
View counts last refreshed date | N/A | The date the view count was last refreshed. See Views definition for refresh schedule. | Content Library |
Threads profile
| Name | API field | Description | Products |
|---|---|---|---|
Name | N/A | Number of the Threads profile, if available. | Content Library |
Followers | N/A | The number of followers of the Threads profile. | Content Library |
Following | N/A | The number of profiles the Threads profile is following. | Content Library |
Is verified | N/A | Whether the Threads profile has a verified badge. A verified badge in this context refers to accounts confirmed as authentic and not to those with a paid Meta Verified subscription. Learn more about Meta verified on Threads. | Content Library |
Username | N/A | Username of the Threads profile. | Content Library |
Biography | N/A | The description of the Threads profile. | Content Library |
Creation date | N/A | The date the Threads profile was created. | Content Library |
Threads reply
| Name | API field | Description | Products |
|---|---|---|---|
Text | N/A | The text of the Threads reply. | Content Library |
Likes | N/A | The number of like reactions on the reply. | Content Library |
Reply count | N/A | The total number of replies to a reply. | Content Library |
Owner name | N/A | The name of the reply owner associated with the Threads reply, if available and user meets eligibility criteria. | Content Library |
Owner username | N/A | The username of the reply owner associated with the Threads reply, if the user meets the eligibility criteria. | Content Library |
Post ID | N/A | Unique ID linked to the Threads reply. This ID cannot be used to search on Meta technologies. | Content Library |
Creation time | N/A | The time the Threads reply was created. | Content Library |
Top-level reply count | N/A | The number of top-level replies to a reply. | Content Library |
Meta Content Library ID | N/A | Unique ID linked to a Threads reply. This unique ID cannot be used to search on Meta technologies. | Content Library |
Owner ID | N/A | Unique ID linked to the owner associated with the Threads reply. This ID cannot be used to search on Meta technologies. | Content Library |
Share search collections
| Name | API field | Description | Products |
|---|---|---|---|
Search ID | id | API search ID generated in Content Library. | Content Library Content Library API |
Creation time | creation_time | The time the shared search was created in Content Library. | Content Library Content Library API |
Search platform | platform | The Platform (Facebook or Instagram) associated with the shared search. | Content Library Content Library API |
Asynchronous filters | filters_async_search | Filters associated with the shared search, validated and formatted for an asynchronous API search call. | Content Library Content Library API |
Synchronous filters | filters_sync_search | Filters associated with the shared search, validated and formatted for a synchronous API search call. | Content Library Content Library API |
API version | version | Latest version of Meta Content Library API at the time the shared search was created. | Content Library Content Library API |
Share producer lists
| Name | API field | Description | Products |
|---|---|---|---|
Producer API list ID | id | API list ID generated in Content Library for the producer list. | Content Library Content Library API |
Producer list name | name | The name of the shared producer list. | Content Library Content Library API |
Producer list platform | platform | The Platform (Facebook or Instagram) associated with the shared producer list. | Content Library Content Library API |
Producer ID | producers.data[].id | Content Library ID of the producer in the producer list. | Content Library Content Library API |
Producer type | producers.data[].type | The type of producer. Producer types include Facebook Pages, groups, events or profiles, or Instagram accounts. | Content Library Content Library API |
Producer name | producers.data[].name | Name of the producer | Content Library Content Library API |