> **For coding agents and LLMs:** This is one page from the Social Fetch docs (markdown export). For curated orientation and workflow guidance, start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for agent onboarding and crawl rules, use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for the full endpoint list with links to pages like this one, use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt); for one platform's parameters and curls, use [`/llms-{platform}.txt`](https://www.socialfetch.dev/llms-tiktok.txt); use [`/llms.json`](https://www.socialfetch.dev/llms.json) when you need structured JSON for tool registration. ## This page - **On-site (HTML):** - **Markdown (.mdx) URL:** ## API base URL and authentication - **API origin (from OpenAPI `servers`):** `https://api.socialfetch.dev` - **Authentication:** send `x-api-key: sfk_...` on `/v1/**` and `/v2/**` routes unless the operation is explicitly anonymous (check OpenAPI `security`, the [API reference hub](https://www.socialfetch.dev/docs/api.mdx), [`/llms.txt`](https://www.socialfetch.dev/llms.txt), or [`/llms.json`](https://www.socialfetch.dev/llms.json) for each route). - **OpenAPI JSON:** ## Recommended docs entrypoints (this site) - [Documentation overview](https://www.socialfetch.dev/docs.mdx) — top-level orientation (markdown). - [Quickstart](https://www.socialfetch.dev/docs/quickstart.mdx) — authenticate with `x-api-key`, validate auth with `whoami`, and understand the JSON envelope. - [SDK](https://www.socialfetch.dev/docs/sdk.mdx) — official TypeScript SDK guide, including `SocialFetchClient`, `Result`, and `unwrap()`. - [Capability matrix](https://www.socialfetch.dev/docs/capability-matrix.mdx) — every operation with identifiers, pagination, outcomes, media download, credits, and its SDK method. Generated from OpenAPI, so use it for route selection instead of scanning individual pages. - [Recipes](https://www.socialfetch.dev/docs/recipes.mdx) — copyable workflows (brand monitoring, transcripts, Ad Library, creator scoring, Reddit research) with credit callouts and SDK examples. - [Integrations](https://www.socialfetch.dev/docs/integrations.mdx) — MCP for AI clients, n8n verified node, Apify Store Actors, Make custom app, SDK, and REST API connection paths. - [MCP product page](https://www.socialfetch.dev/mcp) — hosted MCP overview, OAuth, Skills install. - [MCP integration](https://www.socialfetch.dev/docs/integrations/mcp.mdx) — hosted `/mcp` server, OAuth, Cursor/VS Code/Claude install snippets, 910 endpoint tools, plus docs_search/docs_read for implementation help. - [n8n integration](https://www.socialfetch.dev/docs/integrations/n8n.mdx) — install `n8n-nodes-socialfetch`, credentials, and workflow examples. - [Apify integration](https://www.socialfetch.dev/docs/integrations/apify.mdx) — Store Actors under @social-fetch, PPE billing, dataset export, and quick start. - [Make integration](https://www.socialfetch.dev/docs/integrations/make.mdx) — custom app modules for Make scenarios, API key credentials, and module catalog. - [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt) — every documented operation with a direct link to that route's agent-readable markdown page (prefer this over parsing OpenAPI). - [`/llms-{platform}.txt`](https://www.socialfetch.dev/llms-tiktok.txt) — per-platform endpoint files generated from OpenAPI (parameters, credits, curls). - [`/agents.txt`](https://www.socialfetch.dev/agents.txt) — agent crawl/onboarding file with capabilities, auth rules, and allowlist. - [`/llms.json`](https://www.socialfetch.dev/llms.json) — structured machine-readable operation inventory with parameter names, pagination, outcomes, credits, and SDK mapping. - [API reference hub](https://www.socialfetch.dev/docs/api.mdx) — human-friendly index of operations with links into generated pages. - [Errors](https://www.socialfetch.dev/docs/errors.mdx) — shared error envelope and HTTP status guidance. - [Credits](https://www.socialfetch.dev/docs/credits.mdx) — metering, `402`, and planning batch jobs. - Outcome semantics such as `found`, `not_found`, and `private` are documented in [Errors](https://www.socialfetch.dev/docs/errors.mdx) and on operation pages when present in the OpenAPI contract. ## Markdown docs convention - Every docs page has a markdown twin: append **`.mdx`** to the docs pathname (for example `/docs/quickstart` → `/docs/quickstart.mdx`). - Agents that send `Accept: text/markdown` on `/docs/**` HTML URLs may receive markdown directly (same URL, `Vary: Accept`). - Published blog posts use the same convention: `/blog/{slug}` → `/blog/{slug}.mdx`, or `Accept: text/markdown` on the HTML URL (`Vary: Accept`). --- # Get Lemmy post (https://www.socialfetch.dev/docs/api/v1/lemmy/post/get) ## Summary Get one Lemmy post with its community, cross-posts and moderators. **Tags:** `Lemmy` ## HTTP - **Method:** GET - **Path:** `/v1/lemmy/post` - **Base URL:** `https://api.socialfetch.dev` ## Capability summary - **SDK mapping:** `client.lemmy.getPost({ instance: "lemmy.world", id: 53910627 })` - **Accepted identifiers:** `id` (query), `commentId` (query) - **Pagination:** none - **Business outcome field:** `data.lookupStatus` with values `found`, `not_found`, `private`, `not_compatible` ## Credits - **Base:** 1 credit per successful lookup. - **Maximum on success (200):** 1 credit. - **Failed requests (`lookup_failed`, `503`):** not charged. - **Authoritative field:** `meta.creditsCharged`. ## Authentication - **`x-api-key`**: API key (`sfk_...`) ## Parameters ### `instance` (query) - **Required:** yes - **Constraints:** type `string` - **Description:** The Lemmy instance, e.g. `lemmy.world`. A URL on the instance is also accepted. Ids and counts belong to this instance. ### `id` (query) - **Required:** no - **Constraints:** type `integer`; minimum: 1; maximum: 2147483647 - **Description:** Post id on the chosen instance, e.g. `53910627`. ### `commentId` (query) - **Required:** no - **Constraints:** type `integer`; minimum: 1; maximum: 2147483647 - **Description:** Find the post a comment belongs to. ## Responses (status codes) - **200**: Post. - **400**: Invalid request - **401**: Missing or invalid API key - **402**: Insufficient credits - **500**: Unexpected or billing error - **502**: Lookup could not be completed. - **503**: Service temporarily unavailable; safe to retry with backoff. ## Response body (200) Post. ### Field outline - **data** (required) — type `object`. Endpoint-specific response payload. - **lookupStatus** (required) — type `string`; enum: found, not_found, private, not_compatible. `found`, `not_found` (the entity is missing, or the host name does not resolve), `private` (the instance does not allow public lists) or `not_compatible` (the host is not a Lemmy instance, or its version does not serve this operation). See `reason`. - **instance** (required) — type `string`. The instance that was asked. - **reason** (required) — type `object`; nullable. Why `lookupStatus` is not `found`, or null when it is `found`. - **code** (required) — type `string`; enum: instance_private, not_a_lemmy_instance, not_available, deleted, host_not_found. Machine-readable reason. - **message** (required) — type `string`. Plain-language explanation. - **post** (required) — type `object`; nullable. The post with its cross-posts and moderators when `lookupStatus` is `found`; otherwise null. - **id** (required) — type `integer`. Post id on this instance. - **apId** (required) — type `string`; nullable. Canonical ActivityPub id. - **title** (required) — type `string`; nullable. Post title. - **url** (required) — type `string`; nullable. Link the post points at; null for a text post. - **urlContentType** (required) — type `string`; nullable. Content type of the link. - **thumbnailUrl** (required) — type `string`; nullable. Thumbnail URL. - **nsfw** (required) — type `boolean`; nullable. Whether the post is NSFW. - **locked** (required) — type `boolean`; nullable. Whether the post is locked. - **removed** (required) — type `boolean`; nullable. Whether a moderator removed it. - **deleted** (required) — type `boolean`; nullable. Whether it was deleted. - **publishedAt** (required) — type `string`; nullable. When it was posted. - **updatedAt** (required) — type `string`; nullable. When it last changed. - **languageId** (required) — type `integer`; nullable. Discussion language id. - **isLocal** (required) — type `boolean`; nullable. Whether it was posted on the instance asked. - **score** (required) — type `integer`; nullable. Votes up minus votes down. - **upvotes** (required) — type `integer`; nullable. Upvotes. - **downvotes** (required) — type `integer`; nullable. Downvotes. - **commentCount** (required) — type `integer`; nullable. Comments on the post. - **community** (required) — type `object`. The community it was posted in, with the counts the single-post answer carries. - **id** (required) — type `integer`. Community id on this instance. - **name** (required) — type `string`. Community name without the host. - **title** (required) — type `string`; nullable. Display title. - **actorId** (required) — type `string`; nullable. Canonical ActivityPub id. - **host** (required) — type `string`; nullable. Host the community lives on. - **handle** (required) — type `string`; nullable. `name@host`. - **icon** (required) — type `string`; nullable. Community icon URL. - **nsfw** (required) — type `boolean`; nullable. Whether the community is NSFW. - **isLocal** (required) — type `boolean`; nullable. Whether the community lives on the instance asked. - **description** (required) — type `string`; nullable. Description as Markdown. - **banner** (required) — type `string`; nullable. Banner URL. - **publishedAt** (required) — type `string`; nullable. When the community was created. - **updatedAt** (required) — type `string`; nullable. When the community last changed. - **removed** (required) — type `boolean`; nullable. Whether a moderator removed the community. - **deleted** (required) — type `boolean`; nullable. Whether the community was deleted. - **hidden** (required) — type `boolean`; nullable. Whether the community is hidden. - **postingRestrictedToMods** (required) — type `boolean`; nullable. Whether only moderators may post. - **visibility** (required) — type `string`; nullable. `Public` or another visibility the instance reports. - **subscriberCount** (required) — type `integer`; nullable. Subscribers. - **localSubscriberCount** (required) — type `integer`; nullable. Subscribers on the community's own instance. - **postCount** (required) — type `integer`; nullable. Posts in the community. - **commentCount** (required) — type `integer`; nullable. Comments in the community. - **activeUsers** (required) — type `object`; nullable. Active users in the community. - **moderators** (required) — type `array`; nullable. Moderators; null on list rows, which do not carry them. - _items:_ - **languageIds** (required) — type `array`; nullable. Discussion language ids; null on rows that do not carry them. The instance endpoint maps ids to language codes. - _items:_ - type `integer` - **author** (required) — type `object`; nullable. Who posted it; null on a modlog row, which does not carry the creator. - **id** (required) — type `integer`. User id on this instance. - **name** (required) — type `string`. Username without the host. - **displayName** (required) — type `string`; nullable. Display name. - **bio** (required) — type `string`; nullable. Profile text as Markdown. - **avatar** (required) — type `string`; nullable. Avatar URL. - **banner** (required) — type `string`; nullable. Banner URL. - **actorId** (required) — type `string`; nullable. Canonical ActivityPub id. - **host** (required) — type `string`; nullable. Host the account lives on. - **handle** (required) — type `string`; nullable. `user@host`. - **publishedAt** (required) — type `string`; nullable. When the account was created. - **updatedAt** (required) — type `string`; nullable. When the profile last changed. - **banned** (required) — type `boolean`; nullable. Whether the account is banned. - **banExpiresAt** (required) — type `string`; nullable. When the ban ends. - **deleted** (required) — type `boolean`; nullable. Whether the account was deleted. - **isBot** (required) — type `boolean`; nullable. Whether the account is a bot. - **isLocal** (required) — type `boolean`; nullable. Whether the account lives on the instance asked. - **matrixUserId** (required) — type `string`; nullable. Matrix id the user chose to publish. - **body** (required) — type `string`; nullable. Post text as Markdown. - **embed** (required) — type `object`; nullable. Link preview; null when the instance found none. - **title** (required) — type `string`; nullable. Embedded page title. - **description** (required) — type `string`; nullable. Embedded page description. - **videoUrl** (required) — type `string`; nullable. Embedded video URL. - **altText** (required) — type `string`; nullable. Alt text for the image. - **image** (required) — type `object`; nullable. Image details; null when the post has no image. - **link** (required) — type `string`. Image URL. - **width** (required) — type `integer`; nullable. Width in pixels. - **height** (required) — type `integer`; nullable. Height in pixels. - **contentType** (required) — type `string`; nullable. Media type. - **featuredInCommunity** (required) — type `boolean`; nullable. Whether it is featured in its community. - **featuredOnInstance** (required) — type `boolean`; nullable. Whether it is featured on the instance. - **newestCommentAt** (required) — type `string`; nullable. When the newest comment was made. - **isAdmin** (required) — type `boolean`; nullable. Whether the author is an instance administrator. - **isModerator** (required) — type `boolean`; nullable. Whether the author moderates the community. - **bannedFromCommunity** (required) — type `boolean`; nullable. Whether the author is banned from the community. - **crossPosts** (required) — type `array`; nullable. Posts of the same link in other communities; null on list rows. - _items:_ - **moderators** (required) — type `array`; nullable. Moderators of the community; null on list rows, which do not carry them. - _items:_ - **meta** (required) — type `object`. Metadata describing the request and billing outcome. - **requestId** (required) — type `string`; minLength: 1. Unique request identifier for tracing this API call. - **creditsCharged** (required) — type `integer`; minimum: 0. Credits charged for this request. - **version** (required) — type `string`; enum: v1. Public API version that served the response. ### Example JSON (found) ```json { "data": { "lookupStatus": "found", "instance": "lemmy.world", "reason": null, "post": { "id": 53910627, "apId": "https://sh.itjust.works/post/69325293", "title": "Psssst", "url": "https://img-9gag-fun.9cache.com/photo/ayqEGLX_460swp.webp", "urlContentType": "image/webp", "thumbnailUrl": "https://lemmy.world/pictrs/image/39847cdf-0eda-4d53-a3ff-546d506b7a4d.webp", "nsfw": false, "locked": false, "removed": false, "deleted": false, "publishedAt": "2026-11-02T19:16:58.165Z", "updatedAt": null, "languageId": 0, "isLocal": false, "score": 1713, "upvotes": 1775, "downvotes": 62, "commentCount": 866, "community": { "id": 2657, "name": "politicalmemes", "title": "Political Memes", "actorId": "https://lemmy.ca/c/politicalmemes", "host": "lemmy.ca", "handle": "politicalmemes@lemmy.ca", "icon": "https://sopuli.xyz/pictrs/image/8ac4d606-a8c1-45a3-8e56-4caf030e1b57.webp", "nsfw": false, "isLocal": false, "description": "Memes for not explicit politics: [!memes@sopuli.xyz](https://sopuli.xyz/c/memes) \n\n", "banner": null, "publishedAt": "2022-09-01T16:15:11.970Z", "updatedAt": "2026-10-23T02:20:51.120Z", "removed": false, "deleted": false, "hidden": false, "postingRestrictedToMods": false, "visibility": "Public", "subscriberCount": 2745, "localSubscriberCount": 485, "postCount": 1241, "commentCount": 18414, "activeUsers": { "day": 1126, "week": 3986, "month": 5339, "halfYear": 10278 }, "moderators": null, "languageIds": null }, "author": { "id": 115941, "name": "pelespirit", "displayName": null, "bio": "I make art that's totally mine because I did it through AI. https://imgur.com/a/Rhgi0OC\n\n[Nightshade software to protect your art](https://nightshade.cs.uchicago.edu/whatis.html)", "avatar": "https://sh.itjust.works/pictrs/image/a2212539-eb18-4fba-9bf8-67f6223592e0.png", "banner": "https://sh.itjust.works/pictrs/image/7ccbcaed-77a5-4b3b-931a-2640283b9bc5.png", "actorId": "https://sh.itjust.works/u/pelespirit", "host": "sh.itjust.works", "handle": "pelespirit@sh.itjust.works", "publishedAt": "2023-06-14T15:17:28.537Z", "updatedAt": null, "banned": false, "banExpiresAt": null, "deleted": false, "isBot": false, "isLocal": false, "matrixUserId": null }, "body": null, "embed": null, "altText": null, "image": { "link": "https://lemmy.world/pictrs/image/39847cdf-0eda-4d53-a3ff-546d506b7a4d.webp", "width": 460, "height": 254, "contentType": "image/webp" }, "featuredInCommunity": false, "featuredOnInstance": false, "newestCommentAt": "2026-11-06T21:44:37.828Z", "isAdmin": false, "isModerator": false, "bannedFromCommunity": false, "crossPosts": [ { "id": 53946868, "apId": "https://sh.itjust.works/post/69368360", "title": "Psssst", "url": "https://img-9gag-fun.9cache.com/photo/ayqEGLX_460swp.webp", "urlContentType": "image/webp", "thumbnailUrl": "https://lemmy.world/pictrs/image/1461d84c-2f4a-4795-afca-74884dfced0b.webp", "nsfw": false, "locked": false, "removed": false, "deleted": false, "publishedAt": "2026-11-03T16:41:02.804Z", "updatedAt": null, "languageId": 0, "isLocal": false, "score": 562, "upvotes": 578, "downvotes": 16, "commentCount": 44, "community": { "id": 1384, "name": "politicalmemes", "title": "Political Memes", "actorId": "https://lemmy.world/c/politicalmemes", "host": "lemmy.world", "handle": "politicalmemes@lemmy.world", "icon": "https://lemmy.world/pictrs/image/7f781265-3477-44ec-a7b1-0d21155c0f8d.jpeg", "nsfw": false, "isLocal": true }, "author": { "id": 115941, "name": "pelespirit", "displayName": null, "bio": "I make art that's totally mine because I did it through AI. https://imgur.com/a/Rhgi0OC\n\n[Nightshade software to protect your art](https://nightshade.cs.uchicago.edu/whatis.html)", "avatar": "https://sh.itjust.works/pictrs/image/a2212539-eb18-4fba-9bf8-67f6223592e0.png", "banner": "https://sh.itjust.works/pictrs/image/7ccbcaed-77a5-4b3b-931a-2640283b9bc5.png", "actorId": "https://sh.itjust.works/u/pelespirit", "host": "sh.itjust.works", "handle": "pelespirit@sh.itjust.works", "publishedAt": "2023-06-14T15:17:28.537Z", "updatedAt": null, "banned": false, "banExpiresAt": null, "deleted": false, "isBot": false, "isLocal": false, "matrixUserId": null } } ], "moderators": [ { "id": 140, "name": "QuentinCallaghan", "displayName": "QuentinCallaghan", "bio": "Finnish guy\n\nFounder and admin of sopuli.xyz\n\nMastodon: [Rynach@mstdn.io](https://mstdn.io/@Rynach)\n\nMatrix: @rynach:matrix.org\n", "avatar": "https://sopuli.xyz/pictrs/image/6841cf17-b73e-4320-bac5-57fa1f0e7295.jpeg", "banner": null, "actorId": "https://sopuli.xyz/u/QuentinCallaghan", "host": "sopuli.xyz", "handle": "QuentinCallaghan@sopuli.xyz", "publishedAt": "2021-02-01T15:24:32.478Z", "updatedAt": "2023-02-09T20:19:55.229Z", "banned": false, "banExpiresAt": null, "deleted": false, "isBot": false, "isLocal": false, "matrixUserId": "@rynach:matrix.org" } ] } }, "meta": { "requestId": "req_48e44571-aab0-4593-aeaf-d330ebcf83ed", "creditsCharged": 1, "version": "v1" } } ``` ### Machine-readable error codes When an error JSON body is returned, it may include one of these `error.code` values (derived from the OpenAPI schemas for this operation; additional codes may exist at runtime): - `bad_request` ## Error handling & retries Interpret HTTP status codes using the descriptions below. Do not assume a JSON body unless the OpenAPI schema defines one for that status. - **400**: Invalid request **Retry:** Fix the request; retrying the same invalid payload will not help. - **401**: Missing or invalid API key **Retry:** Fix the API key first; retrying without changes will not help. - **402**: Insufficient credits **Retry:** Do not retry without resolving billing/credits (retrying the same request will not help). - **500**: Unexpected or billing error - **502**: Lookup could not be completed. **Retry:** May be transient; a few retries with backoff are reasonable. - **503**: Service temporarily unavailable; safe to retry with backoff. **Retry:** Usually safe to retry with exponential backoff and jitter. ### Suggested client defaults - Send the API key using the `x-api-key` header on every request. - On `503` (and sometimes `502`), retry with backoff; cap retries and surface a clear error to the user. - On `402`, surface an actionable billing message rather than blind retries. ## Examples ### TypeScript SDK ```typescript import { SocialFetchClient } from "@socialfetch/sdk"; const client = new SocialFetchClient({ apiKey: process.env.SOCIALFETCH_API_KEY!, }); const result = await client.lemmy.getPost({ instance: "lemmy.world", id: 53910627, }); if (!result.ok) { console.error(result.error); } else { console.log(result.value.data); } ``` ### Node.js ```javascript const response = await fetch( "https://api.socialfetch.dev/v1/lemmy/post?instance=lemmy.world&id=53910627", { headers: { "x-api-key": "YOUR_API_KEY" } } ); const data = await response.json(); console.log(data); ``` ### cURL ```bash curl "https://api.socialfetch.dev/v1/lemmy/post?instance=lemmy.world&id=53910627" \ -H "x-api-key: YOUR_API_KEY" ``` ### Python ```python import requests response = requests.get( "https://api.socialfetch.dev/v1/lemmy/post?instance=lemmy.world&id=53910627", headers={"x-api-key": "YOUR_API_KEY"}, ) data = response.json() print(data) ```