social.coves.feed.searchPosts

coves.social

Documentation

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.

main query

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.

Parameters

community string Optional

Restrict results to one community: DID, handle, name@origin, or bare local name. Omit to search every community.

cursor string Optional

No description available.

limit integer Optional

No description available.

q string Required

Search query. Supports quoted phrases and -negation.

sort string Optional

No description available.

timeframe string Optional

Timeframe filter (only applies when sort=top)

Output

Encodingapplication/json
cursor string Optional

No description available.

feed array Required

No description available.

Try It

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

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
Restrict results to one community: DID, handle, name@origin, or bare local name. Omit to search every community.
Search query. Supports quoted phrases and -negation.
Timeframe filter (only applies when sort=top)
View raw schema 
{
  "description": "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.",
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "cursor": {
          "maxLength": 500,
          "type": "string"
        },
        "feed": {
          "items": {
            "ref": "social.coves.feed.defs#feedViewPost",
            "type": "ref"
          },
          "type": "array"
        }
      },
      "required": [
        "feed"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "community": {
        "description": "Restrict results to one community: DID, handle, name@origin, or bare local name. Omit to search every community.",
        "maxLength": 320,
        "type": "string"
      },
      "cursor": {
        "maxLength": 500,
        "type": "string"
      },
      "limit": {
        "default": 15,
        "maximum": 50,
        "minimum": 1,
        "type": "integer"
      },
      "q": {
        "description": "Search query. Supports quoted phrases and -negation.",
        "maxLength": 500,
        "type": "string"
      },
      "sort": {
        "default": "relevance",
        "knownValues": [
          "relevance",
          "new",
          "top"
        ],
        "maxLength": 64,
        "type": "string"
      },
      "timeframe": {
        "default": "all",
        "description": "Timeframe filter (only applies when sort=top)",
        "knownValues": [
          "hour",
          "day",
          "week",
          "month",
          "year",
          "all"
        ],
        "maxLength": 64,
        "type": "string"
      }
    },
    "required": [
      "q"
    ],
    "type": "params"
  },
  "type": "query"
}

Lexicon Garden

@