{"openapi":"3.1.0","info":{"title":"PieFed API","version":"1.0.0","description":"Live community, post and user data from PieFed, an open-source threadiverse platform — a federated Reddit-style link aggregator in the fediverse — via the flagship piefed.social instance's public API. PieFed is organised into communities people subscribe to, where they post links and discussions that others up- and down-vote. List the platform's communities with their subscriber, post and comment counts. Get the feed of posts with each one's title, link, score, vote and comment counts, author and community. Read a single post in full. Read a member's profile with their post and comment counts and join date. Live, no key, nothing stored; to keep results work-safe, NSFW posts and communities are filtered out of the feeds. Distinct from Lemmy, Mbin and other aggregator APIs — this is the PieFed platform, its communities, posts and members. Perfect for social-reader, fediverse and community apps.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/piefed-api","description":"oanor gateway"}],"tags":[{"name":"Posts"},{"name":"Members"},{"name":"Communities"}],"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/post":{"get":{"operationId":"get_v1_post","tags":["Posts"],"summary":"A single post in full","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"PieFed post id","schema":{"type":"string"},"example":"115819"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":115819,"url":"https://x.com/TheNotesOfJosh/status/1791627871519174697","nsfw":false,"score":355,"title":"To my fellow Android custom ROM enthusiasts, I highly advise you uninstall and stop supporting  @projectelixiros","author":"Welp_im_damned","source":"PieFed","upvotes":359,"comments":32,"community":"android","downvotes":4,"published":"2024-05-18T17:41:39.597945Z","community_title":"Android"},"meta":{"timestamp":"2026-06-10T14:02:07.620Z","request_id":"565db3ac-4353-43a6-9fec-c95955cae7db"},"status":"ok","message":"Post 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/posts":{"get":{"operationId":"get_v1_posts","tags":["Posts"],"summary":"The post feed with scores","description":"","parameters":[{"name":"sort","in":"query","required":false,"description":"Hot, New, TopAll, TopWeek","schema":{"type":"string"},"example":"Hot"},{"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":{"sort":"Hot","count":25,"posts":[{"id":2128939,"url":"https://crazypeople.online/pictrs/image/536d10e7-d8a0-4345-ae71-8e912842442b.webp","nsfw":false,"score":88,"title":"What do rule like?","author":"toomanypancakes","upvotes":88,"comments":3,"community":"onehundredninetysix","downvotes":0,"published":"2026-06-10T12:51:41.848720Z","community_title":"196"},{"id":2128907,"url":"https://lemmy.world/pictrs/image/e00aabe8-bd11-4e5a-85c9-725527db8e39.jpeg","nsfw":false,"score":78,"title":"It was worth a shot","author":"The_Picard_Maneuver","upvotes":78,"comments":1,"community":"comicstrips","downvotes":0,"published":"2026-06-10T12:42:01.808508Z","community_title":"Comic Strips"},{"id":2128861,"url":"https://media.piefed.zip/posts/EW/0k/EW0kUYHTPnqbLnL.jpg","nsfw":false,"score":139,"title":"Anyone objecting","author":"RmDebArc_5","upvotes":141,"comments":1,"community":"lemmyshitpost","downvotes":2,"published":"2026-06-10T12:23:05.894074Z","community_title":"Lemmy Shitpost"},{"id":2128843,"url":"https://reddthat.com/pictrs/image/70f659e2-a693-4b70-b26f-545ebc3c2ebf.jpeg","nsfw":false,"score":86,"title":"What's the most embarrassing text you've sent?","author":"LadyButterfly","upvotes":93,"comments":11,"community":"microblogmemes","downvotes":7,"published":"2026-06-10T12:18:20.800431Z","community_title":"Microblog Memes"},{"id":2128811,"url":"https://lemmy.today/pictrs/image/7aa2364c-860c-4801-a6d0-66691bc8974c.jpeg","nsfw":false,"score":129,"title":"Would you sell liquor to this baby?","author":"Wren","upvotes":129,"comments":14,"community":"BrandNewSentence","downvotes":0,"published":"2026-06-10T12:01:50.302072Z","community_title":"Brand New Sentence"},{"id":2128761,"url":"https://media.piefed.zip/posts/rn/Ds/rnDsUrMUT43C4D9.jpg","nsfw":false,"score":112,"title":"Smh my head","author":"RmDebArc_5","upvotes":115,"comments":2,"community":"cat","downvotes":3,"published":"2026-06-10T11:38:05.355335Z","community_title":"cats"},{"id":2128759,"url":"https://media.piefed.world/posts/oz/2A/oz2AndUAQ6dF48x.jpg","nsfw":false,"score":112,"title":"It's not a big ship. It's a series of tubes.","author":"negativenull","upvotes":113,"comments":2,"community":"tenforward","downvotes":1,"published":"2026-06-10T11:36:19.794757Z","community_title":"TenForward: Where Every Vulcan Knows Your Name"},{"id":2128728,"url":"https://theintercept.com/2026/06/10/trump-boat-strikes-human-trafficking-victims/","nsfw":false,"score":146,"title":"Top Pentagon official admits boat strike may have killed victims of human trafficking","author":"MicroWave","upvotes":145,"comments":5,"community":"news","downvotes":-1,"published":"2026-06-10T11:21:46.399059Z","community_title":"News"},{"id":2128674,"url":"https://sh.itjust.works/pictrs/image/60c04f23-715f-458e-b8a2-43b84b3b0664.jpeg","nsfw":false,"score":142,"title":"Only me?","author":"napkin2020","upvotes":143,"comments":19,"community":"memes","downvotes":1,"published":"2026-06-10T11:01:57.147662Z","community_title":"memes"},{"id":2128670,"url":"https://media.piefed.zip/posts/gr/NM/grNM2qC3DtlXuLp.jpg","nsfw":false,"score":132,"title":"And it's only kinda cool","author":"RmDebArc_5","upvotes":135,"comments":5,"community":"tumblr","downvotes":3,"published":"2026-06-10T11:00:01.120868Z","community_title":"tumblr"},{"id":2128633,"url":"https://lemmy.world/pictrs/image/2dbc39c0-a139-473f-aa52-fe8cfdf2dbec.jpeg","nsfw":false,"score":141,"title":"Summer beach bod.","author":"BonesOfTheMoon","upvotes":144,"comments":2,"community":"lemmyshitpost","downvotes":3,"published":"2026-06-10T10:36:35.726566Z","community_title":"Lemmy Shitpost"},{"id":2128617,"url":"https://syzito.files.fedi.monster/media_attachments/files/116/724/773/522/496/662/original/9102742aa8010cf8.jpg","nsfw":false,"score":233,"title":"rule under capitalism is hard","author":"not_IO","upvotes":234,"comments":2,"community":"onehundredninetysix","downvotes":1,"published":"2026-06-10T10:28:46.270554Z","community_title":"196"},{"id":2128614,"url":"https://lemmy.world/pictrs/image/ba629178-34e7-4244-b945-9d4d466e1116.jpeg","nsfw":false,"score":226,"title":"The world, in one paragraph.","author":"ivanafterall","upvotes":229,"comments":18,"community":"aboringdystopia","downvotes":3,"published":"2026-06-10T10:27:50.007186Z","community_title":"A Boring Dystopia"},{"id":2128575,"url":"https://content.federation.network/f/0c81e648-8789-4fdd-8086-e53382304057.webp","nsfw":false,"score":129,"title":"ich🚲🚙 iel Erst mal überholen","author":"daniel","upvotes":129,"comments":32,"community":"ich_iel","downvotes":0,"published":"2026-06-10T10:01:43.766690Z","community_title":"ich_iel"},{"id":2128561,"url":"https://www.androidheadlines.com/2026/06/apple-tried-to-blame-the-eu-for-its-siri-ai-mess-and-the-eu-called-them-out-publicly.html","nsfw":false,"score":147,"title":"Apple tried to blame the EU for its Siri AI mess, and the EU called them out publicly","author":"sanitation","upvotes":150,"comments":14,"community":"technology","downvotes":3,"published":"2026-06-10T09:57:49.334598Z","community_title":"Technology"},{"id":2128435,"url":"https://files.ohai.social/media_attachments/files/116/586/833/898/395/327/original/44d6a1c044e81c6c.jpg","nsfw":false,"score":433,"title":"progress","author":"not_IO","upvotes":434,"comments":26,"community":"comicstrips","downvotes":1,"published":"2026-06-10T08:16:17.639890Z","community_title":"Comic Strips"},{"id":2128188,"url":"https://the-decoder.com/landmark-german-ruling-declares-googles-ai-overviews-are-googles-own-words-and-makes-it-liable-for-false-answers/","nsfw":false,"score":659,"title":"Landmark German ruling declares Google's AI Overviews are Google's own words and makes it liable for false answers","author":"fusspilz","upvotes":659,"comments":36,"community":"technology","downvotes":0,"published":"2026-06-10T05:13:36.411204Z","community_title":"Technology"},{"id":2129034,"url":"https://lemmy.world/pictrs/image/b6eaf10a-4246-4125-9a08-39c9d4eba3de.jpeg","nsfw":false,"score":6,"title":"I have everything I could want!","author":"The_Picard_Maneuver","upvotes":6,"comments":0,"community":"whitepeopletwitter","downvotes":0,"published":"2026-06-10T13:46:05.058618Z","community_title":"People Twitter"},{"id":2129032,"url":"https://piefed.cdn.blahaj.zone/posts/LB/Ae/LBAeAqfZWQ4Iw6i.jpg","nsfw":false,"score":6,"title":"Happy Pride Season!","author":"LadyButterfly","upvotes":6,"comments":0,"community":"womensstuff","downvotes":0,"published":"2026-06-10T13:44:42.085781Z","community_title":"WomensStuff"},{"id":2129021,"url":"https://lemmy.ml/pictrs/image/6af9c01a-6af0-4ecc-8eb0-e0198eeeac89.jpeg","nsfw":false,"score":7,"title":"Maybe they are drawn towards the confidence this process makes them feel?","author":"cm0002","upvotes":7,"comments":2,"community":"memes","downvotes":0,"published":"2026-06-10T13:39:27.416461Z","community_title":"Memes"},{"id":2129018,"url":"https://lemmy.ml/pictrs/image/ab1e01cd-7d8a-4203-9148-27f26b6824ba.jpeg","nsfw":false,"score":8,"title":"A different me, with the same problems.","author":"cm0002","upvotes":8,"comments":0,"community":"memes","downvotes":0,"published":"2026-06-10T13:37:27.274166Z","community_title":"Memes"},{"id":2129012,"url":"https://lemmy.ml/pictrs/image/b7533c9a-9b20-42c3-a9c9-c36dd8247e52.png","nsfw":false,"score":9,"title":"Lost to a moped","author":"cm0002","upvotes":9,"comments":1,"community":"whitepeopletwitter","downvotes":0,"published":"2026-06-10T13:35:45.411679Z","community_title":"People Twitter"},{"id":2129006,"url":"https://lemmy.world/pictrs/image/4f7af1cc-4a07-4d8f-bfcd-997228aec0d5.png","nsfw":false,"score":7,"title":"Terminal Tower of Hanoi, in Bash","author":"cm0002","upvotes":7,"comments":0,"community":"opensource","downvotes":0,"published":"2026-06-10T13:32:28.355345Z","community_title":"Opensource"},{"id":2129001,"url":"https://www.theguardian.com/world/2026/jun/10/sardinian-beach-bans-umbrellas-people-aged-10-65-punta-molentis","nsfw":false,"score":4,"title":"Sardinian beach bans umbrellas for people aged 10 to 65","author":"Wudi","upvotes":4,"comments":1,"community":"europe","downvotes":0,"published":"2026-06-10T13:28:08.709785Z","community_title":"Europe"},{"id":2129000,"url":"https://www.nbcnews.com/business/energy/may-inflation-report-gas-prices-iran-rcna349059","nsfw":false,"score":11,"title":"Inflation jumps to 4.2%, the highest since early 2023","author":"LuminousLuddite","upvotes":11,"comments":1,"community":"news","downvotes":0,"published":"2026-06-10T13:27:47.569483Z","community_title":"News"}],"source":"PieFed"},"meta":{"timestamp":"2026-06-10T14:02:10.097Z","request_id":"071d4699-f441-423f-8ec9-75370ab90006"},"status":"ok","message":"Posts 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/user":{"get":{"operationId":"get_v1_user","tags":["Members"],"summary":"A member profile","description":"","parameters":[{"name":"username","in":"query","required":true,"description":"PieFed username","schema":{"type":"string"},"example":"rimu"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"bot":false,"about":"Web developer. Lead developer of [PieFed](https://join.piefed.social)","posts":860,"source":"PieFed","comments":2175,"username":"rimu","published":"2024-01-04","display_name":"Rimu"},"meta":{"timestamp":"2026-06-10T14:02:11.750Z","request_id":"3cc5ff31-f04b-4f3d-96e1-cee280c6a8fb"},"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/communities":{"get":{"operationId":"get_v1_communities","tags":["Communities"],"summary":"Communities with counts","description":"","parameters":[{"name":"sort","in":"query","required":false,"description":"Active, Hot, New, TopAll","schema":{"type":"string"},"example":"Active"},{"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":{"sort":"Active","count":25,"source":"PieFed","communities":[{"id":241,"name":"privacy","nsfw":false,"posts":3316,"title":"Privacy","published":"2019-11-15","subscribers":1909},{"id":864,"name":"politicalmemes","nsfw":false,"posts":3516,"title":"Political Memes","published":"2023-06-09","subscribers":1582},{"id":828,"name":"enoughmuskspam","nsfw":false,"posts":620,"title":"Enough Musk Spam","published":"2023-06-23","subscribers":57},{"id":39,"name":"politics","nsfw":false,"posts":25509,"title":"politics","published":"2023-06-09","subscribers":1011},{"id":81,"name":"technology","nsfw":false,"posts":12984,"title":"Technology","published":"2023-06-11","subscribers":2664},{"id":14802,"name":"shit","nsfw":false,"posts":224,"title":"ShitPost","published":"2026-04-09","subscribers":12},{"id":1611,"name":"fuck_ai","nsfw":false,"posts":3844,"title":"Fuck AI","published":"2024-03-13","subscribers":382},{"id":5511,"name":"historymemes","nsfw":false,"posts":3863,"title":"History Memes","published":"2025-05-15","subscribers":2606},{"id":402,"name":"whitepeopletwitter","nsfw":false,"posts":256,"title":"People Twitter","published":"2023-06-22","subscribers":1621},{"id":939,"name":"micromobility","nsfw":false,"posts":2292,"title":"micromobility - Bikes, scooters, boards: Whatever floats your goat, this is micromobility","published":"2023-06-11","subscribers":401},{"id":11947,"name":"Gay","nsfw":false,"posts":175,"title":"Gay: News & Community","published":"2025-09-26","subscribers":13},{"id":240,"name":"piracy","nsfw":false,"posts":2575,"title":"Piracy: ꜱᴀɪʟ ᴛʜᴇ ʜɪɢʜ ꜱᴇᴀꜱ","published":"2023-06-09","subscribers":2515},{"id":3171,"name":"giornalismo","nsfw":false,"posts":949,"title":"Giornalismo e disordine informativo","published":"2022-11-17","subscribers":12},{"id":1231,"name":"deutschland","nsfw":false,"posts":3631,"title":"Deutschland","published":"2024-06-22","subscribers":92},{"id":124,"name":"asklemmy","nsfw":false,"posts":7209,"title":"Ask Lemmy","published":"2023-06-11","subscribers":1446},{"id":13050,"name":"pravda_news","nsfw":false,"posts":21132,"title":"Pravda News!","published":"2025-10-23","subscribers":29},{"id":1892,"name":"hackernews","nsfw":false,"posts":2290,"title":"Hacker News","published":"2024-09-11","subscribers":1993},{"id":363,"name":"cybersecurity","nsfw":false,"posts":4959,"title":"Cybersecurity","published":"2023-06-08","subscribers":1430},{"id":477,"name":"science_memes","nsfw":false,"posts":1016,"title":"Science Memes","published":"2023-02-03","subscribers":1815},{"id":960,"name":"wholesome","nsfw":false,"posts":957,"title":"Wholesome","published":"2024-03-21","subscribers":2121},{"id":2228,"name":"onehundredninetysix","nsfw":false,"posts":2517,"title":"196","published":"2025-01-19","subscribers":908},{"id":3007,"name":"nieuws","nsfw":false,"posts":2475,"title":"Nieuws","published":"2023-07-06","subscribers":17},{"id":134,"name":"steamdeck","nsfw":false,"posts":1331,"title":"Steam Hardware","published":"2021-07-19","subscribers":996},{"id":278,"name":"ukraine","nsfw":false,"posts":10876,"title":"Ukraine","published":"2022-08-21","subscribers":1472},{"id":762,"name":"photography","nsfw":false,"posts":168,"title":"Photography","published":"2020-07-09","subscribers":1028}]},"meta":{"timestamp":"2026-06-10T14:02:13.234Z","request_id":"f4a139cd-6ed3-489b-a991-d47194a7d42c"},"status":"ok","message":"Communities 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"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":14000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":600,"monthly_call_quota":182000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1700,"monthly_call_quota":955000,"rps_limit":18,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":4000,"monthly_call_quota":5550000,"rps_limit":35,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/piefed-api"}