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-19'
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: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
    properties:
      - url: openapi/meta-openapi.yml
        type: OpenAPI
  - 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
common:
  - type: PostmanWorkspace
    url: https://www.postman.com/kinlaneapi/meta/overview
  - type: ArazzoWorkflows
    url: arazzo/
    workflows:
      - url: arazzo/meta-add-current-user-to-audience-workflow.yml
        name: Meta Add Current User To Audience
        summary: Resolve the authenticated user and add them to a custom audience.
      - url: arazzo/meta-audit-current-user-workflow.yml
        name: Meta Audit Current User
        summary: Resolve the current user, read their full profile node, then pull their feed.
      - url: arazzo/meta-decommission-user-account-workflow.yml
        name: Meta Decommission User Account
        summary: Snapshot a user, remove them from a custom audience, then delete the test user.
      - url: arazzo/meta-get-current-user-feed-workflow.yml
        name: Meta Get Current User Feed
        summary: Resolve the current user from the access token and read their timeline feed.
      - url: arazzo/meta-onboard-user-to-audience-workflow.yml
        name: Meta Onboard User To Audience
        summary: Confirm a user exists, then add a hashed payload to a custom audience.
      - url: arazzo/meta-provision-then-cleanup-test-user-workflow.yml
        name: Meta Provision Then Cleanup Test User
        summary: Configure a test user with an update, then delete the test user to clean up.
      - url: arazzo/meta-read-user-feed-and-identity-workflow.yml
        name: Meta Read User Feed And Identity
        summary: Read a target user's feed and resolve the caller's own identity for context.
      - url: arazzo/meta-read-user-then-feed-workflow.yml
        name: Meta Read User Then Feed
        summary: Read a specific user's profile and then pull their timeline feed.
      - url: arazzo/meta-refresh-audience-cohort-workflow.yml
        name: Meta Refresh Audience Cohort
        summary: Resolve the caller, add a new cohort to an audience, then remove stale members.
      - url: arazzo/meta-sync-custom-audience-membership-workflow.yml
        name: Meta Sync Custom Audience Membership
        summary: Add a fresh set of hashed users to a custom audience and remove a stale set.
      - url: arazzo/meta-unblock-and-add-to-audience-workflow.yml
        name: Meta Unblock And Add To Audience
        summary: Unblock a user from a page, then add them to a custom audience.
      - url: arazzo/meta-update-current-user-profile-workflow.yml
        name: Meta Update Current User Profile
        summary: Resolve the current user, update their profile, then read it back to confirm.
      - url: arazzo/meta-verify-and-update-user-workflow.yml
        name: Meta Verify And Update User
        summary: Read a user, branch on whether it exists, and apply an update when found.
  - 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'