Facebook Graph API

Name: Facebook Graph API API
Brand: Facebook Graph API
Availability: InStock

★ Only Publicly Available SpecSocial MediaSocial Managementoauth224 EndpointsREST

For Agents

Read user profiles, publish posts, retrieve photos and videos, and moderate comments on the Facebook social graph. Covers 24 endpoints for user content and page management.

Quickstart

Get started with Facebook Graph API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"post to a facebook page"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Facebook Graph API API.

Retrieve authenticated user profile data including name, email, and friend connections

Publish text posts, links, and media to user timelines and managed pages

Fetch photo albums and individual photos with metadata and engagement counts

List and moderate comments on posts including reply threading

GET STARTED

Start building with Facebook Graph API API

Explore with Jentic

View OpenAPI Spec

Use Cases

Patterns agents use Facebook Graph API API for, with concrete tasks.

★ AI Agent Page Management

An AI agent publishes scheduled content to a Facebook Page by calling POST /{page-id}/feed with a message and optional link attachment. Through Jentic, the agent discovers the page publishing operation by searching 'post to facebook page', loads the request schema including required page access token and message fields, and executes without manual Graph API setup. Handles page post creation, comment moderation, and engagement tracking in a single workflow.

Publish a post with message 'New product launch today!' to page-id 123456 via POST /{page-id}/feed and confirm the returned post ID

User Profile and Social Graph Access

Access authenticated user profile data through the /me endpoint including name, email, profile picture, and friend connections. The Graph API returns structured JSON with only the fields requested via the fields parameter, reducing payload size. Supports accessing other users' public profiles via /{user-id} when appropriate permissions are granted.

Retrieve the authenticated user's name, email, and friend count via GET /me?fields=name,email,friends and return the structured profile data

Content Moderation and Engagement

Monitor and moderate comments on posts using GET /{post-id}/comments and DELETE /{post-id}/comments/{comment-id}. Track engagement metrics through GET /{post-id}/likes for like counts and user details. Enables automated content moderation workflows that flag or remove inappropriate comments on page posts within seconds of posting.

Retrieve all comments on post-id 789 via GET /{post-id}/comments, filter for comments containing profanity, and delete flagged comments via DELETE endpoint

Photo and Media Management

Upload photos and videos to user profiles or pages, retrieve album contents with metadata, and access media engagement data. The /{user-id}/photos endpoint returns uploaded photos with creation timestamps, dimensions, and associated comments. Albums are accessible through /{user-id}/albums with full photo enumeration support.

Retrieve all photo URLs from a user's albums via GET /{user-id}/albums followed by GET /{album-id}/photos for each album

Key Endpoints

24 endpoints — jentic publishes the only available openapi specification for facebook graph api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/me

Retrieve authenticated user's profile

GET

/{user-id}/feed

Get posts from a user's timeline

POST

/{user-id}/feed

Publish a post to a user or page timeline

GET

/{post-id}/comments

List comments on a post

GET

/{post-id}/likes

Get likes on a post

GET

/{user-id}/photos

Retrieve user's uploaded photos

GET

/debug_token

Inspect an access token's metadata

GET

/me

Retrieve authenticated user's profile

GET

/{user-id}/feed

Get posts from a user's timeline

POST

/{user-id}/feed

Publish a post to a user or page timeline

GET

/{post-id}/comments

List comments on a post

GET

/{post-id}/likes

Get likes on a post

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Facebook OAuth 2.0 tokens with specific permission scopes are stored encrypted in the Jentic vault (MAXsystem). Agents receive tokens with only the required permissions (user_posts, pages_manage_posts) — raw app secrets and long-lived tokens never enter the agent's context.

Intent-based discovery

Agents search by intent (e.g., 'post to a facebook page') and Jentic returns the matching POST /{page-id}/feed operation with its request schema including required token scopes, so the agent can execute without reading Meta's documentation.

Time to first call

Direct Facebook Graph API integration: 3-5 days for OAuth app review, token management, and permission handling. Through Jentic: under 1 hour — search for the operation, load the schema, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

Instagram API

Photo and video sharing platform owned by Meta, often used alongside Facebook for cross-platform social publishing

Use Instagram API when the task involves photo/video-centric content, visual storytelling, or reaching audiences on Instagram rather than Facebook's text-heavy feed

Alternative

Twitter API v2

Real-time public conversation platform with tweet search and streaming instead of social graph traversal

Choose Twitter when the task requires real-time public content search, streaming filtered tweets, or short-form public messaging rather than social graph interactions

Complementary

Buffer API

Social media scheduling tool for queuing posts to Facebook and other platforms from a single interface

Use Buffer when the agent needs to schedule Facebook posts for future times or manage a cross-platform content calendar rather than posting directly

FAQs

Specific to using Facebook Graph API API through Jentic.

Why is there no official OpenAPI spec for Facebook Graph API?

Meta does not publish an OpenAPI specification for the Graph API. Jentic generates and maintains this spec so that AI agents and developers can call Facebook Graph API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Facebook Graph API use?

The Graph API uses OAuth 2.0 with permission-based access tokens. User access tokens grant permissions like user_posts, user_photos, and user_friends. Page access tokens require pages_manage_posts and pages_read_engagement. Through Jentic, these OAuth tokens are stored encrypted in the MAXsystem vault and agents receive scoped tokens without handling raw app secrets.

Can I publish posts to a Facebook Page through this API?

Yes. Use POST /{page-id}/feed with a valid Page access token that has the pages_manage_posts permission. Include the message field for text content and optionally link or media attachments. The endpoint returns the created post's ID on success.

What are the rate limits for the Facebook Graph API?

The Graph API uses application-level rate limiting. Each app gets 200 calls per user per hour for user-token requests. Page-token requests are limited to 4800 calls per app per hour per page. Rate limit headers (x-app-usage, x-page-usage) are returned with each response indicating current utilization percentage.

How do I retrieve user posts and comments through Jentic?

Install the Jentic SDK with pip install jentic, then search for 'get facebook user feed' to discover the GET /{user-id}/feed operation. Jentic returns the endpoint schema with supported fields parameter options. For comments, search 'list comments on a facebook post' to load the GET /{post-id}/comments schema. Sign up at https://app.jentic.com/sign-up.

Can I access friend lists and social connections?

The GET /{user-id}/friends endpoint returns friends who also use your app, not the complete friend list (restricted since Graph API v2.0). The response includes friend user IDs and names. Use the fields parameter to request additional profile data for each friend within a single request via field expansion.

How do I verify an access token's permissions?

Use the GET /debug_token endpoint with input_token parameter set to the token you want to inspect. The response includes the app_id, user_id, granted scopes, expiration time, and validity status. This is essential for verifying token permissions before making requests that require specific scopes.