app.didpic.feed.getTagFeedPublic

lexicons.didpic.app

Documentation

Unauthenticated tag feed for public web landings. Returns up to `limit` most-recent posts using the hashtag, filtered to those with no labels (post or author) so the public surface never renders age-restricted imagery. `postCount` is the global tag popularity, not the size of the returned slice.

main query

Unauthenticated tag feed for public web landings. Returns up to `limit` most-recent posts using the hashtag, filtered to those with no labels (post or author) so the public surface never renders age-restricted imagery. `postCount` is the global tag popularity, not the size of the returned slice.

Parameters

limit integer Optional

No description available.

tag string Required

Hashtag without the leading #. Lowercased server-side.

Output

Encodingapplication/json
postCount integer Required

Total distinct records (posts + comments) using this tag, ignoring labels.

posts array Required

Up to `limit` recent unlabelled posts. Each post carries its author's PDS for blob URL construction.

tag string 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
Hashtag without the leading #. Lowercased server-side.
View raw schema 
{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "tag",
        "postCount",
        "posts"
      ],
      "properties": {
        "tag": {
          "type": "string"
        },
        "posts": {
          "type": "array",
          "items": {
            "ref": "#postCard",
            "type": "ref"
          },
          "description": "Up to `limit` recent unlabelled posts. Each post carries its author's PDS for blob URL construction."
        },
        "postCount": {
          "type": "integer",
          "minimum": 0,
          "description": "Total distinct records (posts + comments) using this tag, ignoring labels."
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "tag"
    ],
    "properties": {
      "tag": {
        "type": "string",
        "maxLength": 640,
        "description": "Hashtag without the leading #. Lowercased server-side.",
        "maxGraphemes": 64
      },
      "limit": {
        "type": "integer",
        "default": 9,
        "maximum": 25,
        "minimum": 1
      }
    }
  },
  "description": "Unauthenticated tag feed for public web landings. Returns up to `limit` most-recent posts using the hashtag, filtered to those with no labels (post or author) so the public surface never renders age-restricted imagery. `postCount` is the global tag popularity, not the size of the returned slice."
}
postCard object

No description available.

Properties

alt string Optional

No description available.

aspectRatio object Optional

No description available.

authorDid string did Required

A decentralized identifier (DID).

authorDisplayName string Optional

No description available.

authorHandle string handle Optional

An AT Protocol handle (e.g., alice.bsky.social).

cid string cid Required

A content identifier (CID) referencing immutable data.

imageCid string cid Required

A content identifier (CID) referencing immutable data.

pds string uri Optional

Author's PDS endpoint. Use to construct the post's image blob URL.

uri string at-uri Required

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

View raw schema 
{
  "type": "object",
  "required": [
    "uri",
    "cid",
    "authorDid",
    "imageCid"
  ],
  "properties": {
    "alt": {
      "type": "string"
    },
    "cid": {
      "type": "string",
      "format": "cid"
    },
    "pds": {
      "type": "string",
      "format": "uri",
      "description": "Author's PDS endpoint. Use to construct the post's image blob URL."
    },
    "uri": {
      "type": "string",
      "format": "at-uri"
    },
    "imageCid": {
      "type": "string",
      "format": "cid"
    },
    "authorDid": {
      "type": "string",
      "format": "did"
    },
    "aspectRatio": {
      "type": "object",
      "properties": {
        "width": {
          "type": "integer",
          "minimum": 1
        },
        "height": {
          "type": "integer",
          "minimum": 1
        }
      }
    },
    "authorHandle": {
      "type": "string",
      "format": "handle"
    },
    "authorDisplayName": {
      "type": "string"
    }
  }
}

Lexicon Garden

@