community.gifthood.feed.getListings

gifthood.community

Documentation

Fetch listings near a geohash cell, optionally filtered by intent. Returns a page of listingView objects ordered newest-first.

main query

Fetch listings near a geohash cell, optionally filtered by intent. Returns a page of listingView objects ordered newest-first.

Parameters

geohash string Required

The caller's geohash cell. The server truncates this to `precision` characters before querying.

intent string Optional

When supplied, returns only listings of this intent type.

limit integer Optional

Maximum number of listings to return. Defaults to 50; hard cap 100.

mode string Optional

When supplied, returns only listings of this mode ("lend" = the Borrow feed segment). Omitted returns both.

precision integer Optional

Display and query precision (number of geohash characters). Lower values widen the search area.

Output

Encodingapplication/json
cursor string Optional

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

listings 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
The caller's geohash cell. The server truncates this to `precision` characters before querying.
When supplied, returns only listings of this intent type.
Maximum number of listings to return. Defaults to 50; hard cap 100.
When supplied, returns only listings of this mode ("lend" = the Borrow feed segment). Omitted returns both.
Display and query precision (number of geohash characters). Lower values widen the search area.
View raw schema 
{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "listings"
      ],
      "properties": {
        "area": {
          "ref": "community.gifthood.geo.defs#area",
          "type": "ref",
          "description": "The resolved label for the queried (effective) cell — for the feed header. Optional/additive."
        },
        "cursor": {
          "type": "string",
          "description": "Opaque keyset cursor for fetching 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": [
      "geohash"
    ],
    "properties": {
      "mode": {
        "enum": [
          "gift",
          "lend"
        ],
        "type": "string",
        "description": "When supplied, returns only listings of this mode (\"lend\" = the Borrow feed segment). Omitted returns both."
      },
      "limit": {
        "type": "integer",
        "default": 50,
        "maximum": 100,
        "minimum": 1,
        "description": "Maximum number of listings to return. Defaults to 50; hard cap 100."
      },
      "intent": {
        "enum": [
          "offer",
          "request"
        ],
        "type": "string",
        "description": "When supplied, returns only listings of this intent type."
      },
      "geohash": {
        "type": "string",
        "description": "The caller's geohash cell. The server truncates this to `precision` characters before querying."
      },
      "precision": {
        "type": "integer",
        "maximum": 12,
        "minimum": 1,
        "description": "Display and query precision (number of geohash characters). Lower values widen the search area."
      }
    }
  },
  "description": "Fetch listings near a geohash cell, optionally filtered by intent. Returns a page of listingView objects ordered newest-first."
}

Lexicon Garden

@