so.sprk.feed.searchPosts

sprk.so

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Find posts matching search criteria, returning views of those posts.",
      "errors": [
        {
          "name": "BadQueryString"
        }
      ],
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "cursor": {
              "type": "string"
            },
            "hitsTotal": {
              "description": "Count of search hits. Optional, may be rounded/truncated, and may not be possible to paginate through all hits.",
              "type": "integer"
            },
            "posts": {
              "items": {
                "ref": "so.sprk.feed.defs#postView",
                "type": "ref"
              },
              "type": "array"
            }
          },
          "required": [
            "posts"
          ],
          "type": "object"
        }
      },
      "parameters": {
        "properties": {
          "cursor": {
            "description": "Optional pagination mechanism; may not necessarily allow scrolling through entire result set.",
            "type": "string"
          },
          "limit": {
            "default": 25,
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          },
          "q": {
            "description": "Search query string; to match against post descriptions and such.",
            "type": "string"
          },
          "sort": {
            "default": "latest",
            "description": "Specifies the ranking order of results.",
            "knownValues": [
              "top",
              "latest"
            ],
            "type": "string"
          }
        },
        "required": [
          "q"
        ],
        "type": "params"
      },
      "type": "query"
    }
  },
  "id": "so.sprk.feed.searchPosts",
  "lexicon": 1
}

Validate Record

Validate a record against so.sprk.feed.searchPosts

Validation Options
Automatically resolve and include external schemas for full validation
Treat any remaining unresolved references as valid

Metadata

DID
did:plc:cveom2iroj3mt747sd4qqnr2
CID
bafyreigrhze2rlup6we3kugzb6uh3m7luddqninblpzwilx2dgkfx2jtvu
Indexed At
2026-04-21 22:28 UTC
AT-URI
at://did:plc:cveom2iroj3mt747sd4qqnr2/com.atproto.lexicon.schema/so.sprk.feed.searchPosts

Referenced Schemas (1)

Similar Lexicons

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • Find posts matching search criteria, returning views of those posts. Note that this API endpoint may require authentication (eg, not public) for some service providers and implementations.

  • town.delve.feed.searchPosts querynot from the namespace authority

    Find posts matching search criteria, returning views of those posts. Note that this API endpoint may require authentication (eg, not public) for some service providers and implementations.

  • Full-text search over visible posts, across every community or restricted to one. Results honour the same admission, deletion and viewer-block rules as social.coves.feed.getDiscover and social.coves.feed.getCommunity.

  • town.delve.unspecced.searchPostsSkeleton querynot from the namespace authority

    Backend Posts search, returns only skeleton

  • Find posts matching a search query or filters, returning search hits for matching post records.

Lexicon Garden

@