# SF Short-Term Housing Listings API

Fresh San Francisco short-term rental and sublet listings for humans and AI agents.

## Free Preview

GET https://sf-housing.vercel.app/api/preview

Returns a small static cached sample of current listings so agents can inspect the response schema before purchasing. This endpoint ignores all query parameters — it always returns the same sample data regardless of any filters passed.

## Pricing

$1.00 USD per paid query. Pay-per-use, no account required.

Each paid query returns up to 20 matching listings.

## For Humans

Open https://sf-housing.vercel.app/ and choose query parameters:

- min_price: optional minimum monthly rent in USD
- max_price: optional maximum monthly rent in USD

The human purchase button forwards those parameters to checkout.

## For AI Agents

Request a paid query in a single step using Tempo for automatic payment via MPP:

```bash
tempo request -t "https://sf-housing.vercel.app/api/listings?min_price=2000&max_price=3500"
```

## Response Schema

```json
{
  "items": [
    {
      "id": "string",
      "title": "string",
      "price": 2500,
      "price_text": "$2,500",
      "address": "string",
      "location_text": "string",
      "description": "string",
      "listing_url": "string",
      "listing_date": "string",
      "source_subcategory": "string",
      "image_count": 3
    }
  ],
  "meta": { "count": 20 }
}
```