community.gifthood.feed.getAuthorListings

gifthood.community

Documentation

Fetch listings created by a specific author (DID), optionally including gone listings. Returns a page of listingView objects ordered newest-first.

main query

Fetch listings created by a specific author (DID), optionally including gone listings. Returns a page of listingView objects ordered newest-first.

Parameters

author string did Required

DID of the account whose listings to return.

cursor string Optional

Opaque keyset cursor from a previous page. Absent for the first page.

includeGone boolean Optional

Include listings marked 'gone' (claimed). Defaults to false; both current consumers pass true.

limit integer Optional

Max listings to return.

Output

Encodingapplication/json
cursor string Optional

Opaque keyset cursor for the next page. Absent when no further results exist.

listings array Required

No description available.

Errors

NotAvailableToPublic The author hides their content from logged-out viewers; sign in to view.
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
DID of the account whose listings to return.
Opaque keyset cursor from a previous page. Absent for the first page.
Include listings marked 'gone' (claimed). Defaults to false; both current consumers pass true.
Max listings to return.
View raw schema 
{
  "type": "query",
  "errors": [
    {
      "name": "NotAvailableToPublic",
      "description": "The author hides their content from logged-out viewers; sign in to view."
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "listings"
      ],
      "properties": {
        "cursor": {
          "type": "string",
          "description": "Opaque keyset cursor for the next page. Absent when no further results exist."
        },
        "listings": {
          "type": "array",
          "items": {
            "ref": "community.gifthood.feed.defs#listingView",
            "type": "ref"
          }
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "author"
    ],
    "properties": {
      "limit": {
        "type": "integer",
        "default": 50,
        "maximum": 100,
        "minimum": 1,
        "description": "Max listings to return."
      },
      "author": {
        "type": "string",
        "format": "did",
        "description": "DID of the account whose listings to return."
      },
      "cursor": {
        "type": "string",
        "description": "Opaque keyset cursor from a previous page. Absent for the first page."
      },
      "includeGone": {
        "type": "boolean",
        "description": "Include listings marked 'gone' (claimed). Defaults to false; both current consumers pass true."
      }
    }
  },
  "description": "Fetch listings created by a specific author (DID), optionally including gone listings. Returns a page of listingView objects ordered newest-first."
}

Lexicon Garden

@