Meta

aid: meta
url: https://raw.githubusercontent.com/api-search/social/main/_apis/meta/apis.md
accessModel:
  pricing: free
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Free · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
specificationVersion: '0.18'
name: Meta
description: Collection of Meta (Facebook) platform APIs for social networking, messaging, advertising, content publishing,
  AI, and developer tools across Facebook, Instagram, WhatsApp, Threads, and Messenger.
image: https://about.meta.com/brand/resources/meta/our-logo/
tags:
- Advertising
- Analytics
- Artificial Intelligence
- Messaging
- Social
- Social Media
- Virtual Reality
created: '2024-04-14T00:00:00.000Z'
modified: '2026-06-20'
maintainers:
- name: Kin Lane
  email: kin@apievangelist.com
  url: http://apievangelist.com
- name: Meta Platforms Inc.
  email: developer-support@meta.com
  url: https://about.meta.com
apis:
- aid: meta:instagram-graph-api-user
  name: Instagram Graph API - User
  description: Access Instagram user profiles, media, and account information for Business and Creator accounts via the Instagram
    Graph API.
  humanURL: https://developers.facebook.com/docs/instagram-platform
  tags:
  - Instagram
  - Social
  - Users
  properties: []
- aid: meta:facebook-graph-api-page
  name: Facebook Graph API - Page
  description: Access and manage Facebook Page settings, content, posts, and metrics using the Graph API Page node.
  humanURL: https://developers.facebook.com/docs/graph-api/reference/page/
  tags:
  - Facebook
  - Pages
  - Social
  properties: []
- aid: meta:facebook-graph-api-post
  name: Facebook Graph API - Post
  description: Create, read, update, and delete posts on Facebook using the Graph API Post node.
  humanURL: https://developers.facebook.com/docs/graph-api/reference/post/
  tags:
  - Facebook
  - Posts
  - Social
  properties: []
- aid: meta:facebook-graph-api-group
  name: Facebook Graph API - Group
  description: Manage Facebook Groups including members, posts, and settings using the Graph API Group node.
  humanURL: https://developers.facebook.com/docs/graph-api/reference/group/
  tags:
  - Facebook
  - Groups
  - Social
  properties: []
- aid: meta:facebook-graph-api-event
  name: Facebook Graph API - Event
  description: Access and manage Facebook Events including details, attendees, and RSVPs using the Graph API Event node.
  humanURL: https://developers.facebook.com/docs/graph-api/reference/event/
  tags:
  - Events
  - Facebook
  - Social
  properties: []
- aid: meta:facebook-marketing-api
  name: Facebook Marketing API
  description: Create, manage, and optimize advertising campaigns across Facebook, Instagram, and Audience Network programmatically.
  humanURL: https://developers.facebook.com/docs/marketing-api
  tags:
  - Advertising
  - Facebook
  - Marketing
  properties:
  - url: https://developers.facebook.com/docs/marketing-api/reference
    type: Reference
  - url: https://developers.facebook.com/docs/marketing-api/get-started
    type: GettingStarted
- aid: meta:conversions-api
  name: Meta Conversions API
  description: Send web, app, and offline conversion events directly from your server to Meta for improved ad measurement
    and optimization.
  humanURL: https://developers.facebook.com/docs/marketing-api/conversions-api
  tags:
  - Advertising
  - Analytics
  - Conversions
  properties: []
- aid: meta:ad-library-api
  name: Meta Ad Library API
  description: Search and retrieve publicly visible ads across Meta platforms for transparency and research purposes via the
    ads_archive Graph API endpoint.
  humanURL: https://developers.facebook.com/docs/graph-api/reference/ads_archive/
  tags:
  - Advertising
  - Research
  - Transparency
  properties: []
- aid: meta:whatsapp-cloud-api
  name: WhatsApp Cloud API
  description: Send and receive messages, manage phone numbers, and build messaging experiences on WhatsApp using Meta's cloud-hosted
    API.
  humanURL: https://developers.facebook.com/docs/whatsapp/cloud-api
  tags:
  - Cloud
  - Messaging
  - WhatsApp
  properties:
  - url: https://developers.facebook.com/docs/whatsapp/cloud-api/reference
    type: Reference
  - url: https://developers.facebook.com/docs/whatsapp/cloud-api/get-started
    type: GettingStarted
- aid: meta:whatsapp-business-management-api
  name: WhatsApp Business Management API
  description: Manage WhatsApp Business accounts, phone numbers, message templates, and business profiles programmatically.
  humanURL: https://developers.facebook.com/docs/whatsapp/business-management-api
  tags:
  - Business
  - Messaging
  - WhatsApp
  properties: []
- aid: meta:messenger-platform-api
  name: Messenger Platform API
  description: Build messaging experiences on Facebook Messenger including chatbots, rich media messages, and customer service
    integrations.
  humanURL: https://developers.facebook.com/docs/messenger-platform
  tags:
  - Chatbots
  - Messaging
  - Social
  properties:
  - url: https://developers.facebook.com/docs/messenger-platform/reference
    type: Reference
- aid: meta:threads-api
  name: Threads API
  description: Create and manage content, retrieve profiles, and access insights on Meta's Threads social media platform.
  humanURL: https://developers.facebook.com/docs/threads
  tags:
  - Social
  - Social Media
  - Threads
  properties: []
- aid: meta:instagram-graph-api-content-publishing
  name: Instagram Graph API - Content Publishing
  description: Publish photos, videos, carousels, reels, and stories to Instagram Business and Creator accounts programmatically.
  humanURL: https://developers.facebook.com/docs/instagram-platform/instagram-api-with-facebook-login/content-publishing
  tags:
  - Media
  - Publishing
  - Social
  properties: []
- aid: meta:instagram-messaging-api
  name: Instagram Messaging API
  description: Send and receive messages on Instagram using the Messenger Platform, enabling customer service and automated
    messaging for Business accounts.
  humanURL: https://developers.facebook.com/docs/messenger-platform/instagram
  tags:
  - Instagram
  - Messaging
  - Social
  properties: []
- aid: meta:meta-content-library-api
  name: Meta Content Library API
  description: Programmatic access to the full public content archive from Facebook, Instagram, and Threads for qualified
    academic and non-profit researchers.
  humanURL: https://developers.facebook.com/docs/content-library-and-api
  tags:
  - Analytics
  - Content
  - Research
  properties: []
- aid: meta:llama-api
  name: Meta Llama API
  description: Access Meta's Llama large language models including Llama 4 and Llama 3 family for building AI-powered applications
    via a hosted API.
  humanURL: https://llama.developer.meta.com/docs/overview
  tags:
  - Artificial Intelligence
  - Large Language Models
  - Machine Learning
  properties:
  - url: https://llama.developer.meta.com/docs/quickstart
    type: GettingStarted
  - url: https://llama.developer.meta.com/docs/models
    type: Reference
  - url: https://llama.developer.meta.com/docs/sdks
    type: SDKs
  - url: https://llama.developer.meta.com/docs/api-keys
    type: Authentication
- aid: meta:meta-custom-audiences-api
  name: Meta Custom Audiences API
  description: Manage user membership in custom audiences
  humanURL: https://developers.facebook.com/docs/graph-api/reference/user/
  tags:
  - Custom Audiences
  properties:
  - type: OpenAPI
    url: openapi/meta-custom-audiences-api-openapi.yml
  - type: GraphQL
    url: graphql/meta-graphql.md
- aid: meta:meta-pages-api
  name: Meta Pages API
  description: Page-related user operations
  humanURL: https://developers.facebook.com/docs/graph-api/reference/user/
  tags:
  - Pages
  properties:
  - type: OpenAPI
    url: openapi/meta-pages-api-openapi.yml
  - type: GraphQL
    url: graphql/meta-graphql.md
- aid: meta:meta-users-api
  name: Meta Users API
  description: Operations on the User node
  humanURL: https://developers.facebook.com/docs/graph-api/reference/user/
  tags:
  - Users
  properties:
  - type: OpenAPI
    url: openapi/meta-users-api-openapi.yml
  - type: GraphQL
    url: graphql/meta-graphql.md
common:
- type: AgenticAccess
  url: agentic-access/meta-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/meta-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/meta-domain-security.yml
- type: Authentication
  url: authentication/meta-authentication.yml
- type: OAuthScopes
  url: scopes/meta-scopes.yml
- type: Packages
  url: packages/meta-packages.yml
- type: WellKnown
  url: well-known/meta-well-known.yml
- type: SecurityTxt
  url: well-known/meta-security.txt
- type: MCPServer
  url: mcp/meta-mcp.yml
- type: LLMsTxt
  url: llms/meta-llms.txt
- type: Overlay
  url: overlays/meta-openapi-overlay.yaml
- type: Conformance
  url: conformance/meta-conformance.yml
- type: ErrorCatalog
  url: errors/meta-problem-types.yml
- type: Lifecycle
  url: lifecycle/meta-lifecycle.yml
- type: Conventions
  url: conventions/meta-conventions.yml
- type: ChangeLog
  url: changelog/meta-changelog.yml
- type: CLI
  url: cli/meta-cli.yml
- type: Components
  url: components/meta-components.yml
- type: DataModel
  url: data-model/meta-data-model.yml
- type: Sandbox
  url: sandbox/meta-sandbox.yml
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/meta/overview
- type: Arazzo
  url: arazzo/meta-add-current-user-to-audience-workflow.yml
  name: Meta Add Current User To Audience
- type: Arazzo
  url: arazzo/meta-audit-current-user-workflow.yml
  name: Meta Audit Current User
- type: Arazzo
  url: arazzo/meta-decommission-user-account-workflow.yml
  name: Meta Decommission User Account
- type: Arazzo
  url: arazzo/meta-get-current-user-feed-workflow.yml
  name: Meta Get Current User Feed
- type: Arazzo
  url: arazzo/meta-onboard-user-to-audience-workflow.yml
  name: Meta Onboard User To Audience
- type: Arazzo
  url: arazzo/meta-provision-then-cleanup-test-user-workflow.yml
  name: Meta Provision Then Cleanup Test User
- type: Arazzo
  url: arazzo/meta-read-user-feed-and-identity-workflow.yml
  name: Meta Read User Feed And Identity
- type: Arazzo
  url: arazzo/meta-read-user-then-feed-workflow.yml
  name: Meta Read User Then Feed
- type: Arazzo
  url: arazzo/meta-refresh-audience-cohort-workflow.yml
  name: Meta Refresh Audience Cohort
- type: Arazzo
  url: arazzo/meta-sync-custom-audience-membership-workflow.yml
  name: Meta Sync Custom Audience Membership
- type: Arazzo
  url: arazzo/meta-unblock-and-add-to-audience-workflow.yml
  name: Meta Unblock And Add To Audience
- type: Arazzo
  url: arazzo/meta-update-current-user-profile-workflow.yml
  name: Meta Update Current User Profile
- type: Arazzo
  url: arazzo/meta-verify-and-update-user-workflow.yml
  name: Meta Verify And Update User
- type: LinkedIn
  url: https://www.linkedin.com/company/meta
- url: https://developers.facebook.com/?no_redirect=1
  name: Social technologies | Meta for Developers
  type: Portal
- url: https://developers.facebook.com/docs/
  name: Meta Developer Documentation | Meta APIs, SDKs & Guides
  type: Documentation
- url: https://developers.facebook.com/docs/graph-api/overview
  name: Graph API Overview
  type: Overview
- url: https://developers.facebook.com/docs/graph-api/get-started
  name: Get Started
  type: GettingStarted
- url: https://developers.facebook.com/docs/facebook-login
  type: Authentication
- url: https://developers.facebook.com/docs/access-tokens
  name: Access Tokens
  type: Authentication
- url: https://developers.facebook.com/docs/graph-api/changelog
  name: Graph API Changelog
  type: ChangeLog
- url: https://developers.facebook.com/docs/graph-api/reference
  name: Graph API Reference
  type: Reference
- url: https://developers.facebook.com/blog/
  name: News for Developers | Facebook Developers
  type: Blog
- url: https://metastatus.com/
  name: Status
  type: StatusPage
- url: https://developers.facebook.com/apps/
  name: Applications
  type: Console
- url: https://developers.facebook.com/
  name: Sign Up - Meta for Developers
  type: Signup
- url: https://developers.facebook.com/terms/
  name: Platform Terms - Meta for Developers
  type: TermsOfService
- url: https://www.facebook.com/privacy/explanation
  type: PrivacyPolicy
- url: https://developers.facebook.com/support/
  name: Developer Support - Meta for Developers
  type: Support
- url: https://developers.facebook.com/support/bugs/
  name: Platform Bug Reports - Meta for Developers
  type: Bugs
- url: https://developers.facebook.com/community/
  name: Developer Community Forum - Meta for Developers
  type: Forums
- url: https://developers.facebook.com/support/faq/
  name: Developer FAQ - Meta for Developers
  type: FAQ
- url: https://developers.facebook.com/tools/explorer/
  name: Graph API Explorer
  type: Explorer
- url: https://developers.facebook.com/tools/
  name: Developer Tools - Meta for Developers
  type: Tools
- url: https://developers.facebook.com/apps/
  name: All Apps - Meta for Developers
  type: Applications
- url: https://developers.facebook.com/incident/report/
  name: Report an Incident - Meta for Developers
  type: Incident Report
- url: https://developers.facebook.com/m/signup/
  name: Meta for Developers Newsletter | Meta for Developers
  type: Newsletter
- url: https://developers.facebook.com/videos/
  name: Videos for Developers
  type: Videos
- url: https://developers.facebook.com/docs/graph-api/webhooks
  name: Webhooks - Graph API
  type: Webhooks
- url: https://developers.facebook.com/docs/facebook-login/security
  name: Facebook Login Security
  type: Security
- url: https://developers.facebook.com/docs/graph-api/overview/rate-limiting/
  name: Rate Limits - Graph API
  type: RateLimits
- url: https://developers.facebook.com/docs/graph-api/guides/versioning
  name: Versioning - Graph API
  type: Versioning
- url: https://developers.facebook.com/docs/graph-api/results
  name: Paginated Results
  type: Pagination
  mediaType: text/html
- url: https://github.com/facebook
  name: Meta Open Source on GitHub
  type: GitHubOrganization
- url: https://opensource.fb.com/
  name: Meta Open Source
  type: Open Source
- url: https://stackoverflow.com/questions/tagged/facebook-graph-api
  name: Stack Overflow - Facebook Graph API
  type: StackOverflow
- url: https://github.com/facebook/facebook-python-business-sdk
  name: Python SDK
  type: SDKs
- url: https://github.com/facebook/facebook-nodejs-business-sdk
  name: Node.js SDK
  type: SDKs
- url: https://github.com/facebook/facebook-php-business-sdk
  name: PHP SDK
  type: SDKs
- url: https://github.com/facebook/facebook-java-business-sdk
  name: Java SDK
  type: SDKs
- url: https://github.com/facebook/facebook-ruby-business-sdk
  name: Ruby SDK
  type: SDKs
- url: https://github.com/facebook/facebook-ios-sdk
  name: iOS SDK
  type: SDKs
- url: https://github.com/facebook/facebook-android-sdk
  name: Android SDK
  type: SDKs
- url: json-schema/user.json
  name: User Schema
  type: JSONSchema
  mediaType: application/schema+json
  description: JSON Schema for the Meta Graph API User node covering identity, demographics, profile details, and engagement
    fields.
- url: json-schema/page.json
  name: Page Schema
  type: JSONSchema
  mediaType: application/schema+json
  description: JSON Schema for the Meta Graph API Page node covering identity, category, contact information, location, and
    engagement metrics.
- url: json-schema/post.json
  name: Post Schema
  type: JSONSchema
  mediaType: application/schema+json
  description: JSON Schema for the Meta Graph API Post node covering content, authorship, privacy, engagement metrics, and
    attached media.
- url: json-schema/ad-campaign.json
  name: Ad Campaign Schema
  type: JSONSchema
  mediaType: application/schema+json
  description: JSON Schema for the Meta Marketing API Campaign object covering budget, objective, status, bidding, and scheduling
    fields.
- url: json-schema/message.json
  name: Message Schema
  type: JSONSchema
  mediaType: application/schema+json
  description: JSON Schema for Meta messaging across WhatsApp Cloud API, Messenger Platform, and Instagram Messaging covering
    text, media, template, and interactive message types.
- url: json-schema/media.json
  name: Media Schema
  type: JSONSchema
  mediaType: application/schema+json
  description: JSON Schema for Meta media objects across Facebook photos/videos and Instagram media including images, videos,
    carousels, reels, and stories.
- url: json-ld/meta-context.jsonld
  name: JSON-LD Context
  type: JSONLD
  mediaType: application/ld+json
  description: JSON-LD context mapping Meta Graph API entities (User, Page, Post, AdCampaign, Message, Media) to schema.org
    vocabulary for linked data interoperability.
- data:
  - id: free
    name: Free
    entries:
    - geo: US
      unit: 1
      label: User
      limit: 1
      price: Free
      metric: user
      timeFrame: month
      description: Free tier.
    description: Facebook only has a single plan.
  name: Plans
  type: Plans
- url: https://developers.facebook.com/docs/graph-api/overview/rate-limiting/
  data:
  - name: Platform Rate Limits
    type: Platform
    limit: 200
    paths:
    - /v23.0/me
    metric: request
    domains:
    - graph.facebook.com
    timeframe: hours
    operations:
    - getUser
    description: Graph API requests made with an application access token are counted against that apps rate limit. An apps
      call count is the number of calls it can make during a rolling one hour window and is calculated as Calls within one
      hour = 200 * Number of Users. The Number of Users is based on the number of unique daily active users an app has. In
      cases where there are slow periods of daily usage, such as if your app has high activity on weekends but low activity
      over weekdays, the weekly and monthly active Users are used to calculate the number of Users for your app. Apps with
      high daily engagement will have higher rate limits than apps with low daily engagement, regardless of the actual number
      of app installs. Note that this is not a per User limit but a limit on calls made by your app. Any individual User can
      make more than 200 calls per hour using your app, as long as the total calls from your app does not exceed the app maximum.
      For example, if your app has 100 Users, your app can make 20,000 calls per hour. However, your top ten most engaged
      Users could make 19,000 of those calls.
    userMultiplied: true
  name: Rate Limits - Graph API
  type: RateLimits
  description: Working to build as machine-readable schema.
- url: https://developers.facebook.com/docs/graph-api/guides/versioning
  data:
    type: Semantic
    parameter: path
  name: Versioning - Graph API
  type: Versioning
  description: Working to build as machine-readable schema.
- data:
    $id: https://example.com/offset-pagination.schema.json
    type: object
    title: Offset-based Pagination Response
    $schema: https://json-schema.org/draft/2020-12/schema
    examples:
    - data:
      - id: '123'
        name: Item 26
      - id: '456'
        name: Item 27
      - id: '789'
        name: Item 28
      paging:
        next: https://graph.facebook.com/{your-user-id}/feed?limit=25&offset=50
        previous: https://graph.facebook.com/{your-user-id}/feed?limit=25&offset=0
    - data:
      - id: '111'
        name: First item
      - id: '222'
        name: Second item
      paging:
        next: https://graph.facebook.com/{your-user-id}/feed?limit=25&offset=25
    - data:
      - id: '999'
        name: Last item
      paging:
        previous: https://graph.facebook.com/{your-user-id}/feed?limit=25&offset=75
    - data: []
      paging:
        next: https://graph.facebook.com/{your-user-id}/feed?limit=25&offset=50
    required:
    - data
    - paging
    properties:
      data:
        type: array
        items:
          description: Individual data item (schema depends on specific endpoint)
        description: Array containing the endpoint data items for the current offset range
      paging:
        type: object
        properties:
          next:
            type: string
            format: uri
            description: Graph API endpoint URL for the next page of data with updated 'offset' parameter. Absence indicates
              last page.
          previous:
            type: string
            format: uri
            description: Graph API endpoint URL for the previous page of data with updated 'offset' parameter. Absence indicates
              first page.
        description: Pagination metadata and navigation links with offset-based parameters
        minProperties: 1
        additionalProperties: false
    description: JSON schema for offset-based pagination responses using numeric offsets in Graph API
    additionalProperties: false
  name: Offset-based Pagination
  type: Pagination
  mediaType: application/schema+json
  description: Still need to figure out how to reference in OpenAPI.
- data:
    $id: https://example.com/time-pagination.schema.json
    type: object
    title: Facebook Time-based Pagination Response
    $schema: https://json-schema.org/draft/2020-12/schema
    examples:
    - data:
      - id: '123'
        message: Example post
        created_time: 2013-04-02T07:42:34+0000
      - id: '456'
        message: Another post
        created_time: 2013-03-30T15:29:34+0000
      paging:
        next: https://graph.facebook.com/{your-user-id}/feed?limit=25&until=1364587774
        previous: https://graph.facebook.com/{your-user-id}/feed?limit=25&since=1364849754
    - data:
      - id: '789'
        message: First page example
      paging:
        next: https://graph.facebook.com/{your-user-id}/feed?limit=25&until=1364587774
    - data:
      - id: '999'
        message: Last page example
      paging:
        previous: https://graph.facebook.com/{your-user-id}/feed?limit=25&since=1364849754
    required:
    - data
    - paging
    properties:
      data:
        type: array
        items:
          description: Individual data item (schema depends on specific endpoint)
        description: Array containing the endpoint data items for the current time range
      paging:
        type: object
        properties:
          next:
            type: string
            format: uri
            description: Graph API endpoint URL for the next page of data with 'until' timestamp parameter
          previous:
            type: string
            format: uri
            description: Graph API endpoint URL for the previous page of data with 'since' timestamp parameter
        description: Pagination metadata and navigation links with time-based parameters
        minProperties: 1
        additionalProperties: false
    description: JSON schema for time-based pagination responses using Unix timestamps in Graph API
    additionalProperties: false
  name: Time-based Pagination
  type: Pagination
  mediaType: application/schema+json
  description: Still need to figure out how to reference in OpenAPI.
- data:
    $id: https://example.com/cursor-pagination.schema.json
    type: object
    title: Facebook Cursor-based Pagination Response
    $schema: https://json-schema.org/draft/2020-12/schema
    examples:
    - data:
      - id: '123'
        name: Example Item 1
      - id: '456'
        name: Example Item 2
      paging:
        next: https://graph.facebook.com/{your-user-id}/albums?limit=25&after=MTAxNTExOTQ1MjAwNzI5NDE=
        cursors:
          after: MTAxNTExOTQ1MjAwNzI5NDE=
          before: NDMyNzQyODI3OTQw
        previous: https://graph.facebook.com/{your-user-id}/albums?limit=25&before=NDMyNzQyODI3OTQw
    required:
    - data
    - paging
    properties:
      data:
        type: array
        items:
          description: Individual data item (schema depends on specific endpoint)
        description: Array containing the endpoint data items for the current page
      paging:
        type: object
        required:
        - cursors
        properties:
          next:
            type: string
            format: uri
            description: Graph API endpoint URL for the next page of data. Absence indicates last page.
          cursors:
            type: object
            required:
            - after
            - before
            properties:
              after:
                type: string
                pattern: ^[A-Za-z0-9+/=]+$
                description: Cursor pointing to the end of the current page of data
              before:
                type: string
                pattern: ^[A-Za-z0-9+/=]+$
                description: Cursor pointing to the start of the current page of data
            description: Cursor strings marking the boundaries of the current page
            additionalProperties: false
          previous:
            type: string
            format: uri
            description: Graph API endpoint URL for the previous page of data. Absence indicates first page.
        description: Pagination metadata and navigation links
        additionalProperties: false
    description: JSON schema for cursor-based pagination responses used in Graph API
    additionalProperties: false
  name: Cursor-based Pagination
  type: Pagination
  mediaType: application/schema+json
  description: Still need to figure out how to reference in OpenAPI.
- type: Features
  data:
  - 'Meta (Facebook + Instagram + WhatsApp + Threads): hundreds of services across Social + Messaging + Ads'
  - 'Detailed pricing: see https://developers.facebook.com/docs/marketing-api'
  - 'Service: Facebook Graph API'
  - 'Service: Marketing API'
  - 'Service: Instagram Graph API'
  - 'Service: Instagram Basic Display API'
  - 'Service: WhatsApp Business Platform / Cloud API'
  - 'Service: Threads API'
  - 'Service: Messenger Platform'
  - 'Service: Workplace by Meta API (sunset)'
  - 'Service: Meta Conversion API (server-side events)'
  sources:
  - https://developers.facebook.com/docs/marketing-api
  - https://focus.finops.org/
  updated: '2026-05-04'