social.showcase.feed.searchPosts Documentation (EN)

main query

Search items, collections, and profiles (public content only). Authentication optional.

Parameters

cursor string Optional

Pagination cursor

limit integer Optional

No description available.

q string Required

Search query string

type string Optional

Filter by content type

Output

Encodingapplication/json

cursor string Optional

No description available.

results array Required

No description available.

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

cursor Pagination cursor

limit

q * Search query string

type Filter by content type

View raw schema

{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "results"
      ],
      "properties": {
        "cursor": {
          "type": "string",
          "maxLength": 512
        },
        "results": {
          "type": "array",
          "items": {
            "refs": [
              "social.showcase.defs#itemView",
              "social.showcase.defs#collectionView",
              "social.showcase.defs#profileView"
            ],
            "type": "union"
          }
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "q"
    ],
    "properties": {
      "q": {
        "type": "string",
        "maxLength": 300,
        "description": "Search query string"
      },
      "type": {
        "type": "string",
        "maxLength": 20,
        "description": "Filter by content type",
        "knownValues": [
          "items",
          "collections",
          "profiles"
        ]
      },
      "limit": {
        "type": "integer",
        "default": 50,
        "maximum": 100,
        "minimum": 1
      },
      "cursor": {
        "type": "string",
        "maxLength": 512,
        "description": "Pagination cursor"
      }
    }
  },
  "description": "Search items, collections, and profiles (public content only). Authentication optional."
}