Farcaster API V2
- User
- Signer
- Cast
- Feed
- Reaction
- Notifications
- Channel
- Follows
- Storage
- Mini Apps
- Agents
- Fname
- Webhook
- Action
- Mute
- Block
- Ban
- Onchain
- Login
- Metrics
Onchain
Farcaster Hub API
- Info
- Casts
- Reactions
- Links
- UserData
- Fids
- Storage
- Usernames
- Verifications
- OnChainEvents
- Message
- HubEvents
Neynar SDK
- Getting Started with Neynar NodeJS SDK
- SDK v1 to v2 migration guide
Fetch embedded url metadata
curl --request GET \
--url https://api.neynar.com/v2/farcaster/cast/embed/crawl \
--header 'x-api-key: <api-key>'
{
"metadata": {
"_status": "<string>",
"content_type": "<string>",
"content_length": 123,
"image": {
"height_px": 123,
"width_px": 123
},
"video": {
"duration_s": 123,
"stream": [
{
"codec_name": "<string>",
"height_px": 123,
"width_px": 123
}
]
},
"html": {
"favicon": "<string>",
"modifiedTime": "<string>",
"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": [
{
"height": "<string>",
"type": "<string>",
"url": "<string>",
"width": "<string>",
"alt": "<string>"
}
],
"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": [
{
"height": "<string>",
"type": "<string>",
"url": "<string>",
"width": "<string>"
}
],
"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>",
"oembed": {
"type": "rich",
"version": "<string>",
"title": "<string>",
"author_name": "<string>",
"author_url": "<string>",
"provider_name": "<string>",
"provider_url": "<string>",
"cache_age": "<string>",
"thumbnail_url": "<string>",
"thumbnail_width": 123,
"thumbnail_height": 123,
"html": "<string>",
"width": 123,
"height": 123
}
},
"frame": {
"version": "<string>",
"image": "<string>",
"frames_url": "<string>",
"buttons": [
{
"title": "<string>",
"index": 123,
"action_type": "post",
"target": "<string>",
"post_url": "<string>"
}
],
"post_url": "<string>",
"title": "<string>",
"image_aspect_ratio": "<string>",
"input": {
"text": "<string>"
},
"state": {
"serialized": "<string>"
}
}
}
}
Authorizations
API key to authorize requests
Query Parameters
URL to crawl metadata of
Response
Basic data structure of every oembed response see https://oembed.com/
rich
The HTML required to display the resource. The HTML should have no padding or margins. Consumers may wish to load the HTML in an off-domain iframe to avoid XSS vulnerabilities. The markup should be valid XHTML 1.0 Basic.
The width in pixels required to display the HTML.
The height in pixels required to display the HTML.
A text title, describing the resource.
The name of the author/owner of the resource.
A URL for the author/owner of the resource.
The name of the resource provider.
The url of the resource provider.
The suggested cache lifetime for this resource, in seconds. Consumers may choose to use this value or not.
A URL to a thumbnail image representing the resource. The thumbnail must respect any maxwidth and maxheight parameters. If this parameter is present, thumbnail_width and thumbnail_height must also be present.
The width of the optional thumbnail. If this parameter is present, thumbnail_url and thumbnail_height must also be present.
The height of the optional thumbnail. If this parameter is present, thumbnail_url and thumbnail_width must also be present.
Mini app v1 object
Version of the mini app, 'next' for v2, 'vNext' for v1
URL of the image
Launch URL of the mini app
Index of the button
The action type of a mini app button. Action types "mint" & "link" are to be handled on the client side only and so they will produce a no/op for POST /farcaster/frame/action.
post
, post_redirect
, tx
, link
, mint
Title of the button
Target of the button
Used specifically for the tx action type to post a successful transaction hash
Post URL to take an action on this mini app
Was this page helpful?
curl --request GET \
--url https://api.neynar.com/v2/farcaster/cast/embed/crawl \
--header 'x-api-key: <api-key>'
{
"metadata": {
"_status": "<string>",
"content_type": "<string>",
"content_length": 123,
"image": {
"height_px": 123,
"width_px": 123
},
"video": {
"duration_s": 123,
"stream": [
{
"codec_name": "<string>",
"height_px": 123,
"width_px": 123
}
]
},
"html": {
"favicon": "<string>",
"modifiedTime": "<string>",
"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": [
{
"height": "<string>",
"type": "<string>",
"url": "<string>",
"width": "<string>",
"alt": "<string>"
}
],
"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": [
{
"height": "<string>",
"type": "<string>",
"url": "<string>",
"width": "<string>"
}
],
"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>",
"oembed": {
"type": "rich",
"version": "<string>",
"title": "<string>",
"author_name": "<string>",
"author_url": "<string>",
"provider_name": "<string>",
"provider_url": "<string>",
"cache_age": "<string>",
"thumbnail_url": "<string>",
"thumbnail_width": 123,
"thumbnail_height": 123,
"html": "<string>",
"width": 123,
"height": 123
}
},
"frame": {
"version": "<string>",
"image": "<string>",
"frames_url": "<string>",
"buttons": [
{
"title": "<string>",
"index": 123,
"action_type": "post",
"target": "<string>",
"post_url": "<string>"
}
],
"post_url": "<string>",
"title": "<string>",
"image_aspect_ratio": "<string>",
"input": {
"text": "<string>"
},
"state": {
"serialized": "<string>"
}
}
}
}