Meta

aid: meta
url: https://raw.githubusercontent.com/api-search/social/main/_apis/meta/apis.md
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-05-04'
maintainers:
  - name: Kin Lane
    email: [email protected]
    url: http://apievangelist.com
  - name: Meta Platforms Inc.
    email: [email protected]
    url: https://about.meta.com
apis:
  - aid: meta:facebook-graph-api-user
    name: Facebook Graph API - User
    description: Retrieve and manage Facebook user profiles, friends lists, and account data using the
      Graph API User node.
    humanURL: https://developers.facebook.com/docs/graph-api/reference/user/
    tags:
      - Facebook
      - Social
      - Users
  - 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
  - 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
  - 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
  - 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
  - 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
  - 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: Getting Started
  - 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
  - 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
  - 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: Getting Started
  - 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
  - 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
  - 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
  - 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
  - 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
  - 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: Getting Started
      - 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
common:
  - 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: Getting Started
  - 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: Change Log
  - 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: Status
  - url: https://developers.facebook.com/apps/
    name: Applications
    type: Console
  - url: https://developers.facebook.com/
    name: Sign Up - Meta for Developers
    type: Sign Up
  - url: https://developers.facebook.com/terms/
    name: Platform Terms - Meta for Developers
    type: Terms of Service
  - url: https://www.facebook.com/privacy/explanation
    type: Privacy Policy
  - 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: Rate Limits
  - 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: GitHub Organization
  - 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: Stack Overflow
  - 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: JSON-LD
    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: Rate Limits
    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'