Meta · Schema
Meta Graph API Post
Represents a Facebook or Instagram post as returned by the Graph API Post node. Includes content, authorship, targeting, engagement metrics, and attached media.
AdvertisingAnalyticsArtificial IntelligenceMessagingSocialSocial MediaVirtual Reality
Properties
| Name | Type | Description |
|---|---|---|
| id | string | The unique identifier for the post, formatted as {page-id}_{post-id} for Page posts. |
| message | string | The text content of the post. |
| story | string | The auto-generated story text for system-generated posts (e.g. 'Jane updated her profile picture'). |
| created_time | string | The time the post was created, in ISO 8601 format. |
| updated_time | string | The time the post was last updated, in ISO 8601 format. |
| from | object | The user, Page, or entity that created the post. |
| to | object | Profiles mentioned or targeted in the post. |
| permalink_url | string | The permanent URL to the post on Facebook. |
| full_picture | string | URL to the full-size picture attached to the post. |
| picture | string | URL to the thumbnail picture attached to the post. |
| icon | string | URL to the icon representing the type of post. |
| type | string | The type of the post. |
| status_type | string | A more descriptive classification of the post type. |
| is_published | boolean | Whether the post is published (visible) or in draft/scheduled state. |
| is_hidden | boolean | Whether the post has been hidden from the timeline. |
| is_expired | boolean | Whether the post has expired (for offer posts). |
| is_popular | boolean | Whether the post is marked as popular based on engagement. |
| is_instagram_eligible | boolean | Whether the post is eligible to be promoted on Instagram. |
| privacy | object | The privacy settings of the post. |
| place | object | The location associated with the post. |
| shares | object | Share count for the post. |
| likes | object | Summary of likes/reactions on the post. |
| comments | object | Summary of comments on the post. |
| attachments | object | Media and link attachments on the post. |
| message_tags | array | Profiles tagged in the post message text. |
| application | object | The application that created the post. |
| scheduled_publish_time | number | Unix timestamp for when a scheduled post will be published. |
| backdated_time | string | The backdated time for the post, if it was backdated. |
JSON Schema
{
"$id": "https://meta.com/schemas/graph-api/post.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"title": "Meta Graph API Post",
"description": "Represents a Facebook or Instagram post as returned by the Graph API Post node. Includes content, authorship, targeting, engagement metrics, and attached media.",
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The unique identifier for the post, formatted as {page-id}_{post-id} for Page posts."
},
"message": {
"type": "string",
"description": "The text content of the post."
},
"story": {
"type": "string",
"description": "The auto-generated story text for system-generated posts (e.g. 'Jane updated her profile picture')."
},
"created_time": {
"type": "string",
"format": "date-time",
"description": "The time the post was created, in ISO 8601 format."
},
"updated_time": {
"type": "string",
"format": "date-time",
"description": "The time the post was last updated, in ISO 8601 format."
},
"from": {
"type": "object",
"description": "The user, Page, or entity that created the post.",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
}
},
"to": {
"type": "object",
"description": "Profiles mentioned or targeted in the post.",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
}
}
}
}
},
"permalink_url": {
"type": "string",
"format": "uri",
"description": "The permanent URL to the post on Facebook."
},
"full_picture": {
"type": "string",
"format": "uri",
"description": "URL to the full-size picture attached to the post."
},
"picture": {
"type": "string",
"format": "uri",
"description": "URL to the thumbnail picture attached to the post."
},
"icon": {
"type": "string",
"format": "uri",
"description": "URL to the icon representing the type of post."
},
"type": {
"type": "string",
"enum": [
"link",
"status",
"photo",
"video",
"offer"
],
"description": "The type of the post."
},
"status_type": {
"type": "string",
"enum": [
"mobile_status_update",
"created_note",
"added_photos",
"added_video",
"shared_story",
"created_group",
"created_event",
"wall_post",
"app_created_story",
"published_story",
"tagged_in_photo",
"approved_friend"
],
"description": "A more descriptive classification of the post type."
},
"is_published": {
"type": "boolean",
"description": "Whether the post is published (visible) or in draft/scheduled state."
},
"is_hidden": {
"type": "boolean",
"description": "Whether the post has been hidden from the timeline."
},
"is_expired": {
"type": "boolean",
"description": "Whether the post has expired (for offer posts)."
},
"is_popular": {
"type": "boolean",
"description": "Whether the post is marked as popular based on engagement."
},
"is_instagram_eligible": {
"type": "boolean",
"description": "Whether the post is eligible to be promoted on Instagram."
},
"privacy": {
"type": "object",
"description": "The privacy settings of the post.",
"properties": {
"value": {
"type": "string",
"enum": [
"EVERYONE",
"ALL_FRIENDS",
"FRIENDS_OF_FRIENDS",
"SELF",
"CUSTOM"
],
"description": "The privacy value of the post."
},
"description": {
"type": "string",
"description": "Human-readable description of the privacy setting."
},
"allow": {
"type": "string",
"description": "Comma-separated list of user IDs allowed to see the post."
},
"deny": {
"type": "string",
"description": "Comma-separated list of user IDs denied from seeing the post."
}
}
},
"place": {
"type": "object",
"description": "The location associated with the post.",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"location": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"country": {
"type": "string"
},
"latitude": {
"type": "number"
},
"longitude": {
"type": "number"
},
"state": {
"type": "string"
},
"street": {
"type": "string"
},
"zip": {
"type": "string"
}
}
}
}
},
"shares": {
"type": "object",
"description": "Share count for the post.",
"properties": {
"count": {
"type": "integer",
"description": "The number of times the post has been shared."
}
}
},
"likes": {
"type": "object",
"description": "Summary of likes/reactions on the post.",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
}
}
},
"summary": {
"type": "object",
"properties": {
"total_count": {
"type": "integer"
},
"can_like": {
"type": "boolean"
},
"has_liked": {
"type": "boolean"
}
}
}
}
},
"comments": {
"type": "object",
"description": "Summary of comments on the post.",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"from": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
}
},
"created_time": {
"type": "string",
"format": "date-time"
}
}
}
},
"summary": {
"type": "object",
"properties": {
"total_count": {
"type": "integer"
},
"can_comment": {
"type": "boolean"
}
}
}
}
},
"attachments": {
"type": "object",
"description": "Media and link attachments on the post.",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"media_type": {
"type": "string",
"description": "The type of media (photo, video, link, album, etc.)."
},
"type": {
"type": "string",
"description": "The attachment type identifier."
},
"url": {
"type": "string",
"format": "uri",
"description": "URL of the attachment."
},
"title": {
"type": "string",
"description": "Title of the attachment."
},
"description": {
"type": "string",
"description": "Description of the attachment."
},
"media": {
"type": "object",
"description": "The media object if the attachment contains media.",
"properties": {
"image": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"src": {
"type": "string",
"format": "uri"
},
"width": {
"type": "integer"
}
}
}
}
}
}
}
}
}
},
"message_tags": {
"type": "array",
"description": "Profiles tagged in the post message text.",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"type": {
"type": "string"
},
"offset": {
"type": "integer",
"description": "Character offset into the message where the tag starts."
},
"length": {
"type": "integer",
"description": "Length of the tagged text."
}
}
}
},
"application": {
"type": "object",
"description": "The application that created the post.",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"namespace": {
"type": "string"
}
}
},
"scheduled_publish_time": {
"type": "number",
"description": "Unix timestamp for when a scheduled post will be published."
},
"backdated_time": {
"type": "string",
"format": "date-time",
"description": "The backdated time for the post, if it was backdated."
}
},
"additionalProperties": true,
"examples": [
{
"id": "123456789012345_987654321098765",
"message": "Excited to announce our new product launch!",
"created_time": "2025-06-15T14:30:00+0000",
"from": {
"id": "123456789012345",
"name": "Example Business Page"
},
"type": "photo",
"status_type": "added_photos",
"is_published": true,
"permalink_url": "https://www.facebook.com/examplebusiness/posts/987654321098765",
"full_picture": "https://scontent.xx.fbcdn.net/v/example-photo.jpg",
"shares": {
"count": 42
},
"likes": {
"summary": {
"total_count": 1250,
"can_like": true,
"has_liked": false
}
},
"comments": {
"summary": {
"total_count": 89,
"can_comment": true
}
}
}
]
}