social.coves.actor.getPosts Documentation (EN)

main query

Get a user's posts for their profile page.

Parameters

actor string at-identifier Required

DID or handle of the user

community string at-identifier Optional

Filter to posts in a specific community

cursor string Optional

No description available.

filter string Optional

Filter for post types

limit integer Optional

No description available.

Output

Encodingapplication/json

cursor string Optional

No description available.

feed array Required

No description available.

Errors

NotFound Actor not found

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

actor * DID or handle of the user

community Filter to posts in a specific community

cursor

filter Filter for post types

limit

View raw schema

{
  "type": "query",
  "errors": [
    {
      "name": "NotFound",
      "description": "Actor not found"
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "feed"
      ],
      "properties": {
        "feed": {
          "type": "array",
          "items": {
            "ref": "social.coves.feed.defs#feedViewPost",
            "type": "ref"
          }
        },
        "cursor": {
          "type": "string",
          "maxLength": 500
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "actor"
    ],
    "properties": {
      "actor": {
        "type": "string",
        "format": "at-identifier",
        "description": "DID or handle of the user"
      },
      "limit": {
        "type": "integer",
        "default": 50,
        "maximum": 100,
        "minimum": 1
      },
      "cursor": {
        "type": "string",
        "maxLength": 500
      },
      "filter": {
        "type": "string",
        "default": "posts-with-replies",
        "maxLength": 64,
        "description": "Filter for post types",
        "knownValues": [
          "posts-with-replies",
          "posts-no-replies",
          "posts-with-media"
        ]
      },
      "community": {
        "type": "string",
        "format": "at-identifier",
        "description": "Filter to posts in a specific community"
      }
    }
  },
  "description": "Get a user's posts for their profile page."
}