Skip to content

Browse free stuff near a place​

GET
/free-stuff

Available items, nearest first from near (the browser's position, sent once the person allows it), else the city's center, else the signed-in person's own place; newest first with no point. Each shows the area and a distance band, never the pickup address or a pin. A city with nothing of its own shows what is within 25 miles, with nearby: true. A person the giver blocked never sees the giver's items. No account needed.

Authorizations​

or
BearerAuth

In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.

Type
HTTP (bearer)

Parameters​

Query Parameters

city

A city's slug.

Type
string
near

lat,lng of the browser.

Type
string
Example"38.68,-121.18"
category

Category ids, comma-separated.

Type
string
Example"baby_kids,kitchen"
distance

Within this many miles of the point (1, 2, 5, 10 or 25 in the filters).

Type
number
Example5
pickup

Pickup methods; an item offering any of them matches.

Type
string
Example"porch,public_place"
limit
Type
integer
Default
24
Maximum
48
offset
Type
integer
Default
0

Responses​

Items.

application/json
JSON
{
"items": [
],
"total": 0,
"limit": 0,
"offset": 0,
"city": {
"slug": "string",
"name": "string",
"region": "string"
},
"nearby": true,
"from": "string"
}

Playground​

Server
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI

Built with VitePress