social.coves.community.post.search

coves.social

Documentation

Search for posts

main query

Search for posts

Parameters

author string at-identifier Optional

Filter by author

community string at-identifier Optional

Filter by specific community

cursor string Optional

No description available.

limit integer Optional

No description available.

q string Required

Search query

sort string Optional

No description available.

tags array of string Optional

Filter by tags

timeframe string Optional

No description available.

type string Optional

Filter by post type

Output

Encodingapplication/json
cursor string Optional

No description available.

posts 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
Filter by author
Filter by specific community
Search query
Filter by tags
Filter by post type
View raw schema
{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "posts"
      ],
      "properties": {
        "posts": {
          "type": "array",
          "items": {
            "ref": "social.coves.feed.defs#feedViewPost",
            "type": "ref"
          }
        },
        "cursor": {
          "type": "string",
          "maxLength": 500
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "q"
    ],
    "properties": {
      "q": {
        "type": "string",
        "maxLength": 500,
        "description": "Search query"
      },
      "sort": {
        "type": "string",
        "default": "relevance",
        "maxLength": 64,
        "knownValues": [
          "relevance",
          "new",
          "top"
        ]
      },
      "tags": {
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 640,
          "maxGraphemes": 64
        },
        "description": "Filter by tags"
      },
      "type": {
        "type": "string",
        "maxLength": 64,
        "description": "Filter by post type",
        "knownValues": [
          "text",
          "image",
          "video",
          "article",
          "microblog"
        ]
      },
      "limit": {
        "type": "integer",
        "default": 50,
        "maximum": 100,
        "minimum": 1
      },
      "author": {
        "type": "string",
        "format": "at-identifier",
        "description": "Filter by author"
      },
      "cursor": {
        "type": "string",
        "maxLength": 500
      },
      "community": {
        "type": "string",
        "format": "at-identifier",
        "description": "Filter by specific community"
      },
      "timeframe": {
        "type": "string",
        "default": "all",
        "maxLength": 64,
        "knownValues": [
          "hour",
          "day",
          "week",
          "month",
          "year",
          "all"
        ]
      }
    }
  },
  "description": "Search for posts"
}

Lexicon Garden

@