Instagram · OpenAPI Overlay 1.0.0

API Evangelist enrichment overlay - Instagram Graph Comments Mentions API

3 actions 3 updates update extends instagram-mentions-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Instagram's API. It is a proposal applied on top of the contract, not a document Instagram publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-enrichmentx-apievangelist-artifactsx-apievangelist-error-catalogx-apievangelist-error-envelope

Targets 3

$.info
$
$.paths.*.*.responses

OpenAPI Overlay

Raw ↑
overlay: 1.0.0
info:
  title: API Evangelist enrichment overlay - Instagram Graph Comments Mentions API
  version: 1.0.0
  x-generated: '2026-08-29'
  x-method: generated
  x-source: openapi/instagram-mentions-api-openapi.yml
  x-description: Captures API Evangelist enrichment on top of the original definition. Does not mutate
    the original; apply with an Overlay 1.0.0 processor.
extends: instagram-mentions-api-openapi.yml
actions:
- target: $.info
  description: Record the enrichment provenance and the version drift against the live Graph API.
  update:
    x-apievangelist-enrichment:
      repo: https://github.com/api-evangelist/instagram
      generated: '2026-08-29'
      spec-graph-api-version: '21.0'
      live-graph-api-version: v26.0
      live-version-released: '2026-07-29'
      drift-note: This definition describes Graph API v21.0; live is v26.0. Meta silently redirects expired-version
        calls to the next oldest usable version.
- target: $
  description: Attach the repo artifacts that carry the runtime semantics this definition does not express.
  update:
    x-apievangelist-artifacts:
      authentication: authentication/instagram-authentication.yml
      scopes: scopes/instagram-scopes.yml
      conventions: conventions/instagram-conventions.yml
      errors: errors/instagram-problem-types.yml
      rate-limits: rate-limits/instagram-rate-limits.yml
      lifecycle: lifecycle/instagram-lifecycle.yml
      webhooks: asyncapi/instagram-webhooks.yml
      data-model: data-model/instagram-data-model.yml
      conformance: conformance/instagram-conformance.yml
      packages: packages/instagram-packages.yml
      sandbox: sandbox/instagram-sandbox.yml
      agentic-access: agentic-access/instagram-agentic-access.yml
- target: $.paths.*.*.responses
  description: Note that Meta error responses are not described in this contract; the catalog is docs-derived.
  update:
    x-apievangelist-error-catalog: errors/instagram-problem-types.yml
    x-apievangelist-error-envelope: error.{message,type,code,error_subcode,error_user_title,error_user_msg,fbtrace_id}
      - not RFC 9457

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this
  • find_overlaysBrowse and filter every overlay in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This overlay
curl "https://apis.io/api/v1/overlays/instagram-mentions-api-overlay"
All openapi overlays
curl "https://apis.io/api/v1/overlays?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.