Sign in

v1

latestOpenAPI 3.0.42026-07-26159287356.1 KB
Frame

Mini apps catalog

A curated list of featured mini apps

get/v2/farcaster/frame/catalog/

Query parameters

limitinteger
Example:100

Number of results to fetch

cursorstring

Pagination cursor

time_window'1h' | '6h' | '12h' | '24h' | '7d'
Example:7d

Time window used to calculate the change in trending score for each mini app, used to sort mini app results

categoriesstring[]

Comma separated list of categories to include in the results. Includes all if left blank. Example: categories=games,social OR categories=games&categories=social

[
  "games",
  "social"
]
networksstring[]

List of blockchain networks by which to filter results. Mini apps included in the results will specify at least one of the supplied networks or specify none. The list can be provided as comma-separated string or array.

[
  "ethereum",
  "base",
  "solana"
]

Response

Success

Example response

{
  "frames": [
    {
      "author": {
        "auth_addresses": [
          {
            "address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
            "app": {
              "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
              "fid": 3
            }
          }
        ],
        "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
        "fid": 3,
        "profile": {
          "bio": {
            "mentioned_profiles": [
              {
                "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
                "fid": 3
              }
            ]
          }
        },
        "verifications": [
          "0x5a927ac639636e534b678e81768ca19e2c6280b7"
        ],
        "verified_addresses": {
          "eth_addresses": [
            "0x5a927ac639636e534b678e81768ca19e2c6280b7"
          ],
          "primary": {
            "eth_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7"
          }
        }
      }
    }
  ]
}