Neynar · Schema

HtmlMetadata

Neynar Farcaster API schema for HtmlMetadata

FarcasterSocialDecentralizedWeb3BlockchainSocial GraphCastsChannelsFeedsReactionsNotificationWebhookOnchain

Properties

Name	Type	Description
favicon	string
modifiedTime	string
oembed	object
ogArticleAuthor	string
ogArticleExpirationTime	string
ogArticleModifiedTime	string
ogArticlePublishedTime	string
ogArticlePublisher	string
ogArticleSection	string
ogArticleTag	string
ogAudio	string
ogAudioSecureURL	string
ogAudioType	string
ogAudioURL	string
ogAvailability	string
ogDate	string
ogDescription	string
ogDeterminer	string
ogEpisode	string
ogImage	array
ogLocale	string
ogLocaleAlternate	string
ogLogo	string
ogMovie	string
ogPriceAmount	string
ogPriceCurrency	string
ogProductAvailability	string
ogProductCondition	string
ogProductPriceAmount	string
ogProductPriceCurrency	string
ogProductRetailerItemId	string
ogSiteName	string
ogTitle	string
ogType	string
ogUrl	string
ogVideo	array
ogVideoActor	string
ogVideoActorId	string
ogVideoActorRole	string
ogVideoDirector	string
ogVideoDuration	string
ogVideoOther	string
ogVideoReleaseDate	string
ogVideoSecureURL	string
ogVideoSeries	string
ogVideoTag	string
ogVideoTvShow	string
ogVideoWriter	string
ogWebsite	string
updatedTime	string

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://neynar.com/schemas/HtmlMetadata",
  "title": "HtmlMetadata",
  "description": "Neynar Farcaster API schema for HtmlMetadata",
  "properties": {
    "favicon": {
      "type": "string"
    },
    "modifiedTime": {
      "type": "string"
    },
    "oembed": {
      "discriminator": {
        "mapping": {
          "link": "#/components/schemas/OembedLinkData",
          "photo": "#/components/schemas/OembedPhotoData",
          "rich": "#/components/schemas/OembedRichData",
          "video": "#/components/schemas/OembedVideoData"
        },
        "propertyName": "type"
      },
      "oneOf": [
        {
          "$ref": "#/components/schemas/OembedRichData"
        },
        {
          "$ref": "#/components/schemas/OembedVideoData"
        },
        {
          "$ref": "#/components/schemas/OembedPhotoData"
        },
        {
          "$ref": "#/components/schemas/OembedLinkData"
        }
      ],
      "type": "object"
    },
    "ogArticleAuthor": {
      "type": "string"
    },
    "ogArticleExpirationTime": {
      "type": "string"
    },
    "ogArticleModifiedTime": {
      "type": "string"
    },
    "ogArticlePublishedTime": {
      "type": "string"
    },
    "ogArticlePublisher": {
      "type": "string"
    },
    "ogArticleSection": {
      "type": "string"
    },
    "ogArticleTag": {
      "type": "string"
    },
    "ogAudio": {
      "type": "string"
    },
    "ogAudioSecureURL": {
      "type": "string"
    },
    "ogAudioType": {
      "type": "string"
    },
    "ogAudioURL": {
      "type": "string"
    },
    "ogAvailability": {
      "type": "string"
    },
    "ogDate": {
      "type": "string"
    },
    "ogDescription": {
      "type": "string"
    },
    "ogDeterminer": {
      "type": "string"
    },
    "ogEpisode": {
      "type": "string"
    },
    "ogImage": {
      "items": {
        "$ref": "#/components/schemas/ImageObject"
      },
      "type": "array"
    },
    "ogLocale": {
      "type": "string"
    },
    "ogLocaleAlternate": {
      "type": "string"
    },
    "ogLogo": {
      "type": "string"
    },
    "ogMovie": {
      "type": "string"
    },
    "ogPriceAmount": {
      "type": "string"
    },
    "ogPriceCurrency": {
      "type": "string"
    },
    "ogProductAvailability": {
      "type": "string"
    },
    "ogProductCondition": {
      "type": "string"
    },
    "ogProductPriceAmount": {
      "type": "string"
    },
    "ogProductPriceCurrency": {
      "type": "string"
    },
    "ogProductRetailerItemId": {
      "type": "string"
    },
    "ogSiteName": {
      "type": "string"
    },
    "ogTitle": {
      "type": "string"
    },
    "ogType": {
      "type": "string"
    },
    "ogUrl": {
      "type": "string"
    },
    "ogVideo": {
      "items": {
        "$ref": "#/components/schemas/VideoObject"
      },
      "type": "array"
    },
    "ogVideoActor": {
      "type": "string"
    },
    "ogVideoActorId": {
      "type": "string"
    },
    "ogVideoActorRole": {
      "type": "string"
    },
    "ogVideoDirector": {
      "type": "string"
    },
    "ogVideoDuration": {
      "type": "string"
    },
    "ogVideoOther": {
      "type": "string"
    },
    "ogVideoReleaseDate": {
      "type": "string"
    },
    "ogVideoSecureURL": {
      "type": "string"
    },
    "ogVideoSeries": {
      "type": "string"
    },
    "ogVideoTag": {
      "type": "string"
    },
    "ogVideoTvShow": {
      "type": "string"
    },
    "ogVideoWriter": {
      "type": "string"
    },
    "ogWebsite": {
      "type": "string"
    },
    "updatedTime": {
      "type": "string"
    }
  },
  "type": "object"
}

Work with this as data

Every JSON Schema 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 schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema 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 JSON Schema

curl "https://apis.io/api/v1/json-schemas/htmlmetadata"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

GitHub Google LinkedIn

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