{"openapi":"3.1.0","info":{"title":"Farcaster API","version":"1.0.0","description":"A live window into Farcaster, the decentralised social network, as an API via the public Warpcast feed. Look a user up by username or FID for their profile (followers, following, bio); pull a user's recent casts (posts) with their likes, recasts and replies; browse the channels people post in, ranked by followers, or filter them; or open a single channel. The on-chain social graph delivered as clean JSON for social, web3 and dashboard apps. Live data, no key. Distinct from Mastodon, Bluesky and other social platforms — this is Farcaster.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/farcaster-api","description":"oanor gateway"}],"tags":[{"name":"Users"},{"name":"Casts"},{"name":"Channels"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/user":{"get":{"operationId":"get_v1_user","tags":["Users"],"summary":"User profile by username or FID","description":"","parameters":[{"name":"username","in":"query","required":false,"description":"Username (preferred)","schema":{"type":"string"},"example":"dwr.eth"},{"name":"fid","in":"query","required":false,"description":"Numeric Farcaster ID","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"user":{"bio":"Interested in technology and other stuff.","fid":3,"active":false,"pfp_url":"https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/bc698287-5adc-4cc5-a503-de16963ed900/original","username":"dwr","followers":345106,"following":77,"power_badge":false,"profile_url":"https://warpcast.com/dwr","display_name":"Dan Romero"}},"meta":{"timestamp":"2026-06-09T03:03:08.119Z","request_id":"03a205c5-d54f-4828-b5a4-49feef7024d2"},"status":"ok","message":"User retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/casts":{"get":{"operationId":"get_v1_casts","tags":["Casts"],"summary":"A user's recent casts","description":"","parameters":[{"name":"username","in":"query","required":false,"description":"Username","schema":{"type":"string"},"example":"dwr.eth"},{"name":"fid","in":"query","required":false,"description":"Numeric FID","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max 1-50","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"fid":3,"casts":[{"url":"https://warpcast.com/dwr/0x5e462315","hash":"0x5e462315f1d12a2f8a579656c1455c5793964fac","likes":176,"author":"dwr","recasts":15,"replies":15,"timestamp":"2026-06-02T00:23:37.000Z"},{"url":"https://warpcast.com/dwr/0xd91e39f1","hash":"0xd91e39f1f09babe39ae5755eb876d54d20bc0cef","likes":248,"author":"dwr","recasts":23,"replies":20,"timestamp":"2026-05-15T23:20:40.000Z"},{"url":"https://warpcast.com/dwr/0xd04b5fa7","hash":"0xd04b5fa7b7e345b91aa950b98ff130ab75f1a2be","likes":171,"author":"dwr","recasts":10,"replies":11,"timestamp":"2026-05-14T01:54:04.000Z"},{"url":"https://warpcast.com/dwr/0xcec60a65","hash":"0xcec60a658b4e0329256820dcbd416440fa9bde13","likes":282,"author":"dwr","recasts":21,"replies":24,"timestamp":"2026-05-12T16:51:42.000Z"},{"url":"https://warpcast.com/dwr/0xd658bb46","hash":"0xd658bb462c7c1781db1cb65beaef891563ce6c0c","text":"Bain*","likes":2,"author":"dwr","recasts":0,"replies":0,"timestamp":"2026-05-06T02:40:15.000Z"},{"url":"https://warpcast.com/dwr/0xf7c1ab29","hash":"0xf7c1ab298cdaaaf2497ab0320b509d57e879a56e","text":"Smart","likes":62,"author":"dwr","recasts":5,"replies":4,"timestamp":"2026-05-04T21:59:04.000Z"},{"url":"https://warpcast.com/dwr/0xb305a5f8","hash":"0xb305a5f81039d7baf0158a27935667742a9582d8","likes":153,"author":"dwr","recasts":7,"replies":15,"timestamp":"2026-05-04T21:54:38.000Z"},{"url":"https://warpcast.com/dwr/0x5cc540d0","hash":"0x5cc540d00132b1f329fdcf9290b59ebefdcd8075","likes":96,"author":"dwr","recasts":7,"replies":5,"timestamp":"2026-05-04T21:37:54.000Z"},{"url":"https://warpcast.com/dwr/0x4c7a1e2f","hash":"0x4c7a1e2fd876fe4fc8cd3d190f3ab728a5f0d002","text":"i’ve really fallen of if @v is higher on a poasting leaderboard","likes":330,"author":"dwr","recasts":25,"replies":28,"timestamp":"2026-05-04T21:22:35.000Z"},{"url":"https://warpcast.com/dwr/0x08e602f7","hash":"0x08e602f733bb4a266eb3c9cc94a3cb0d431cda00","text":"I have no idea","likes":2,"author":"dwr","channel":"gmfarcaster","recasts":0,"replies":1,"timestamp":"2026-04-24T13:57:59.000Z"}],"count":10},"meta":{"timestamp":"2026-06-09T03:03:09.027Z","request_id":"bb41be24-824b-45df-806b-ca986faee2b3"},"status":"ok","message":"Casts retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/channel":{"get":{"operationId":"get_v1_channel","tags":["Channels"],"summary":"Single channel by id","description":"","parameters":[{"name":"channelId","in":"query","required":true,"description":"Channel id","schema":{"type":"string"},"example":"farcaster"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"channel":{"id":"farcaster","url":"https://warpcast.com/~/channel/farcaster","name":"Farcaster","lead_fid":1,"followers":445481,"image_url":"https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/51ffff68-b05c-4465-37a3-38e0c9a21300/original","description":"Discussions about Farcaster on Farcaster (meta!)"}},"meta":{"timestamp":"2026-06-09T03:03:09.272Z","request_id":"dca6be47-1b6f-45ca-9b7c-edaa8f4ac9f9"},"status":"ok","message":"Channel retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/channels":{"get":{"operationId":"get_v1_channels","tags":["Channels"],"summary":"Channel directory by followers","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Filter, e.g. crypto","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max 1-100","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":25,"total":16432,"channels":[{"id":"base","url":"https://warpcast.com/~/channel/base","name":"Base","lead_fid":12142,"followers":480977,"image_url":"https://warpcast.com/~/channel-images/base.png","description":"Bringing the world onchain — a community of builders on Base"},{"id":"farcaster","url":"https://warpcast.com/~/channel/farcaster","name":"Farcaster","lead_fid":1,"followers":445481,"image_url":"https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/51ffff68-b05c-4465-37a3-38e0c9a21300/original","description":"Discussions about Farcaster on Farcaster (meta!)"},{"id":"memes","url":"https://warpcast.com/~/channel/memes","name":"Memes","lead_fid":576,"followers":441637,"image_url":"https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/b67f1620-f2c7-458a-7f8b-d2c1742d7300/original","description":"Funny memes, wholesome memes, and everything in-between. Subscribe to earn."},{"id":"ethereum","url":"https://warpcast.com/~/channel/ethereum","name":"Ethereum","lead_fid":2301,"followers":334308,"image_url":"https://warpcast.com/~/channel-images/ethereum.png","description":"Discussions about Ethereum."},{"id":"founders","url":"https://warpcast.com/~/channel/founders","name":"Founders","lead_fid":2134,"followers":234692,"image_url":"https://warpcast.com/~/channel-images/founders.png","description":"A space for founders"},{"id":"design","url":"https://warpcast.com/~/channel/design","name":"Design","lead_fid":4923,"followers":221728,"image_url":"https://i.imgur.com/4PDpB2a.gif","description":"/Design is a channel for an by designers.\nDesign Channel Publication: paragraph.com/@designchannel"},{"id":"zk","url":"https://warpcast.com/~/channel/zk","name":"zk","lead_fid":16148,"followers":197839,"image_url":"https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/93fb872c-8268-4c14-b1ac-affc69626600/original","description":"Discussions about zero knowledge proofs, related cryptography and its applications."},{"id":"dev","url":"https://warpcast.com/~/channel/dev","name":"dev","lead_fid":191,"followers":183313,"image_url":"https://ipfs.decentralized-content.com/ipfs/bafkreigbei45ni5zsliszzeivotgee5auj2ykkh6zrzjwvm4izviidusny","description":"Cultivating curiosity for software developers"},{"id":"food","url":"https://warpcast.com/~/channel/food","name":"Food","lead_fid":378,"followers":180376,"image_url":"https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/722bd4fe-9b37-47e7-c232-c68426193400/original","description":"A place to talk about what you're cooking and eating. Casts generated by bots, stock photos, and AI generated images will be hidden, and may result in the user being banned from the channel."},{"id":"zora","url":"https://warpcast.com/~/channel/zora","name":"Zora","lead_fid":8,"followers":172378,"image_url":"https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/e49fbe15-894f-4918-1ecc-ee21c3e20800/original","description":"Trade what's trending."},{"id":"fitness","url":"https://warpcast.com/~/channel/fitness","name":"Fitness","lead_fid":10259,"followers":147913,"image_url":"https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/ce5e105d-1300-45be-cf2b-8bb5589c9700/original","description":"Discussions about exercise, health, nutrition and more"},{"id":"fc-updates","url":"https://warpcast.com/~/channel/fc-updates","name":"fc-updates","lead_fid":194,"followers":143291,"image_url":"https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/938a0004-b076-4f57-bf9b-3770f86a1b00/original","description":"Important updates about things happening in Farcaster"},{"id":"warpcast","url":"https://warpcast.com/~/channel/warpcast","name":"Warpcast","lead_fid":3,"followers":136428,"image_url":"https://ipfs.decentralized-content.com/ipfs/bafkreifezhnp5wzgabkdbkb6d65oix4r5axibupv45r7ifxphl4d6qqnry","description":"Announcements, questions, feedback and suggestions about Warpcast"},{"id":"frontend","url":"https://warpcast.com/~/channel/frontend","name":"Frontend","lead_fid":3854,"followers":131716,"image_url":"https://ipfs.decentralized-content.com/ipfs/bafkreibv27igqil44vdeohccdmjdnrpoj6e4xsq6zlmp2is3vscoyau6yq","description":"Discussions about frontend development, HTML, CSS, JavaScript, browser APIs, web standards, component frameworks, rendering libraries, UI/UX patterns, and tools and technologies used to build websites and web apps!"},{"id":"nouns","url":"https://warpcast.com/~/channel/nouns","name":"Nouns","lead_fid":3974,"followers":123758,"image_url":"https://warpcast.com/~/channel-images/nouns.png","description":"A channel for Nouns and Nounish things."},{"id":"degen","url":"https://warpcast.com/~/channel/degen","name":"Degen","lead_fid":15983,"followers":121208,"image_url":"https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/4728a50a-1669-4334-1f57-9473c04a2500/original","description":"Welcome to the /degen channel, a place for risk-takers and meme-makers. Ape into trades, flip NFTs, share your wins (and losses), and drop your best alpha. Flex your PnL, keep it fun, and respect the vibes. We’re all just degens chasing the next big move."},{"id":"frames","url":"https://warpcast.com/~/channel/frames","name":"frames","lead_fid":2,"followers":101444,"image_url":"https://i.imgur.com/vz4KzeC.jpg","description":"Discussion about Farcaster Frames."},{"id":"superrare","url":"https://warpcast.com/~/channel/superrare","name":"SuperRare","lead_fid":270678,"followers":96876,"image_url":"https://warpcast.com/~/channel-images/superrare.jpg","description":"The culture exchange"},{"id":"music","url":"https://warpcast.com/~/channel/music","name":"Music","lead_fid":3115,"followers":93219,"image_url":"https://ipfs.decentralized-content.com/ipfs/bafybeibdk7mvrhmud76ye6wm623sjgtiashik2imee7dkeliiq4wfissqq"},{"id":"art","url":"https://warpcast.com/~/channel/art","name":"Art","lead_fid":9218,"followers":92446,"image_url":"https://ipfs.decentralized-content.com/ipfs/bafkreibrpwjcp2tykkzanqgrzaofxfsf2or7xvhb37wpzg6miazloph6fi","description":"Both art you make and art you like. Please attribute the creator when posting work that is not your own. Strive to be a conscious member of this channel and share work that sparks conversation."},{"id":"replyguys","url":"https://warpcast.com/~/channel/replyguys","name":"/replyguys","lead_fid":5034,"followers":87846,"image_url":"https://i.imgur.com/xDBupZD.jpg","description":"an unmoderated forum moderated by a self proclaimed benevolent dictator"},{"id":"tabletop","url":"https://warpcast.com/~/channel/tabletop","name":"Tabletop","lead_fid":9391,"followers":85005,"image_url":"https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/b853b44c-0221-4f32-3913-f277ce0d6e00/original","description":"Discussions, memes, and casts about board games, TTRPGs, and their digital equivalents"},{"id":"books","url":"https://warpcast.com/~/channel/books","name":"Books","lead_fid":129,"followers":80081,"image_url":"https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/44e5f409-f698-4e97-9283-860ab6597800/rectcrop3","description":"A vibrant community of readers where we discuss ideas, learn together, and recommend books to help each other grow. DM  for an invite with a link to a bookish cast you’ve posted."},{"id":"itookaphoto","url":"https://warpcast.com/~/channel/itookaphoto","name":"I Took a Photo!","lead_fid":283056,"followers":75234,"image_url":"https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/95377fde-4d5c-48e1-bca9-3fb1d5ff2200/original","description":"Photography is the world's most popular art form. ITAP is a place to share photos YOU took. Start casts w/ ITAP or I took a photo & a description. Cast your shot! Sister channels: ITAV, AITap, ITAS. Banner by  Created by "},{"id":"airstack","url":"https://warpcast.com/~/channel/airstack","name":"Moxie Official","lead_fid":565051,"followers":68518,"image_url":"https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/2c2fd4f3-c6ab-4298-bd58-df843114cd00/original","description":"Your starting point for everything Moxie. You must hold 0.1 /airstack fan tokens to cast into the channel. Casts about token price or off-topic casts will results in bans. For support - join our TG: https://t.me/+EM5xiv78bfA1ZTIx"}]},"meta":{"timestamp":"2026-06-09T03:03:10.577Z","request_id":"699f5e04-f097-40b8-8528-04fc69b682b1"},"status":"ok","message":"Channels retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Warpcast public API (live)","service":"farcaster-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/user":"Profile by username (username=dwr.eth) or fid=.","GET /v1/casts":"A user's recent casts (username= or fid=, limit).","GET /v1/channel":"Single channel by id (channelId=farcaster).","GET /v1/channels":"Channel directory ranked by followers (q= filter, limit)."},"description":"Live data from Farcaster, the decentralised social network, via the public Warpcast API: user profiles (by username or FID) with followers/following/bio, a user's recent casts with likes/recasts/replies, the channel directory ranked by followers, and single-channel lookup. Live, no key. Distinct from Mastodon, Bluesky and other social platforms.","channels_indexed":16432},"meta":{"timestamp":"2026-06-09T03:03:11.643Z","request_id":"3b0c29af-d13f-4187-a35e-4f38c59d5555"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":500,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1000,"monthly_call_quota":13500,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2300,"monthly_call_quota":64000,"rps_limit":30,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":5000,"monthly_call_quota":320000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/farcaster-api"}