Lexicon Garden

community.gifthood.feed.getListings

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

Repository @gifthood.community did:plc:7prvtl4j6wsfmkrfrnwknuxj namespace authority
Details · query
Kindquery
Authorityfeed.gifthood.community
Indexed
Compare Edit in builder → Fork →

Query

query · GET

Parameters

query string

geohash

requiredstring

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

intent

string

When supplied, returns only listings of this intent type.

  • enum: offer | request

limit

integer

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

  • minimum: 1
  • maximum: 100
  • default: 50

mode

string

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

  • enum: gift | lend

precision

integer

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

  • minimum: 1
  • maximum: 12

Output

application/json

area

ref

The resolved label for the queried (effective) cell — for the feed header. Optional/additive.

Reference

cursor

string

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

listings

requiredarray

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • community.gifthood.feed.getListingInterests

    query

    List the interests ('raised hands') on a listing, each with the interested person's resolved identity. Rows are viewer-block-filtered, newest first; totalCount reflects all interests (the public count).