social.coves.community.post.get Documentation (EN)

main query

Get posts by AT-URI. Supports batch fetching for feed hydration. Returns posts in same order as input URIs. Auth optional: when authenticated, viewer state is populated.

Parameters

uris array of string Required

List of post AT-URIs to fetch (max 25)

Output

Encodingapplication/json

posts array Required

Array of post views. May include notFound/blocked entries for missing posts.

Errors

InvalidRequest Invalid URI format or empty array

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Service Endpoint Base URL for XRPC calls (e.g., https://api.bsky.social)

Parameters

uris * List of post AT-URIs to fetch (max 25)

View raw schema

{
  "type": "query",
  "errors": [
    {
      "name": "InvalidRequest",
      "description": "Invalid URI format or empty array"
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "posts"
      ],
      "properties": {
        "posts": {
          "type": "array",
          "items": {
            "refs": [
              "social.coves.community.post.defs#postView",
              "social.coves.community.post.defs#notFoundPost",
              "social.coves.community.post.defs#blockedPost"
            ],
            "type": "union"
          },
          "description": "Array of post views. May include notFound/blocked entries for missing posts."
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "uris"
    ],
    "properties": {
      "uris": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "at-uri"
        },
        "maxLength": 25,
        "minLength": 1,
        "description": "List of post AT-URIs to fetch (max 25)"
      }
    }
  },
  "description": "Get posts by AT-URI. Supports batch fetching for feed hydration. Returns posts in same order as input URIs. Auth optional: when authenticated, viewer state is populated."
}