fyi.atstore.directory.searchListings

atstore.fyi

Documentation

Directory listing search and pagination (verified listings with a listing.detail AT URI only).

main query

Directory listing search and pagination (verified listings with a listing.detail AT URI only).

Parameters

cursor string Optional

No description available.

limit integer Optional

No description available.

q string Optional

No description available.

sort string Optional

No description available.

Output

Encodingapplication/json
cursor string Optional

No description available.

listings array Required

No description available.

Errors

InvalidCursor
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
View raw schema 
{
  "type": "query",
  "errors": [
    {
      "name": "InvalidCursor"
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "listings"
      ],
      "properties": {
        "cursor": {
          "type": "string",
          "maxLength": 512
        },
        "listings": {
          "type": "array",
          "items": {
            "ref": "#listingCardSearch",
            "type": "ref"
          }
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "properties": {
      "q": {
        "type": "string",
        "maxLength": 512
      },
      "sort": {
        "enum": [
          "popular",
          "newest",
          "alphabetical"
        ],
        "type": "string",
        "default": "popular",
        "maxLength": 24
      },
      "limit": {
        "type": "integer",
        "default": 24,
        "maximum": 100,
        "minimum": 1
      },
      "cursor": {
        "type": "string",
        "maxLength": 512
      }
    }
  },
  "description": "Directory listing search and pagination (verified listings with a listing.detail AT URI only)."
}
listingCardSearch object

No description available.

Properties

accent string Required

No description available.

maxLength: 16 bytes
Known values: blue, pink, purple, green
appTags array of string Required

No description available.

category string Required

No description available.

maxLength: 640 bytes
categorySlug string Optional

No description available.

maxLength: 512 bytes
categorySlugs array of string Required

No description available.

description string Required

No description available.

maxLength: 20000 bytes
heroImageUrl string Optional

No description available.

maxLength: 8192 bytes
iconUrl string Optional

No description available.

maxLength: 8192 bytes
name string Required

No description available.

maxLength: 640 bytes
priceLabel string Required

No description available.

maxLength: 32 bytes
productAccountHandle string Optional

No description available.

maxLength: 512 bytes
rating string Optional

No description available.

maxLength: 16 bytes
reviewCount integer Required

No description available.

tagline string Required

No description available.

maxLength: 2000 bytes
uri string at-uri Required

AT URI of the fyi.atstore.listing.detail record.

maxLength: 2560 bytes
View raw schema 
{
  "type": "object",
  "required": [
    "uri",
    "name",
    "tagline",
    "description",
    "category",
    "accent",
    "reviewCount",
    "priceLabel",
    "appTags",
    "categorySlugs"
  ],
  "properties": {
    "uri": {
      "type": "string",
      "format": "at-uri",
      "maxLength": 2560,
      "description": "AT URI of the fyi.atstore.listing.detail record."
    },
    "name": {
      "type": "string",
      "maxLength": 640
    },
    "accent": {
      "type": "string",
      "maxLength": 16,
      "knownValues": [
        "blue",
        "pink",
        "purple",
        "green"
      ]
    },
    "rating": {
      "type": "string",
      "nullable": true,
      "maxLength": 16
    },
    "appTags": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 256
      }
    },
    "iconUrl": {
      "type": "string",
      "nullable": true,
      "maxLength": 8192
    },
    "tagline": {
      "type": "string",
      "maxLength": 2000
    },
    "category": {
      "type": "string",
      "maxLength": 640
    },
    "priceLabel": {
      "type": "string",
      "maxLength": 32
    },
    "description": {
      "type": "string",
      "maxLength": 20000
    },
    "reviewCount": {
      "type": "integer"
    },
    "categorySlug": {
      "type": "string",
      "nullable": true,
      "maxLength": 512
    },
    "heroImageUrl": {
      "type": "string",
      "nullable": true,
      "maxLength": 8192
    },
    "categorySlugs": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 512
      }
    },
    "productAccountHandle": {
      "type": "string",
      "nullable": true,
      "maxLength": 512
    }
  }
}

Lexicon Garden

@