---
title: "Search live used-Mac listings across marketplaces"
method: GET
path: "/api/v1/listings"
---

# Search live used-Mac listings across marketplaces

`GET /api/v1/listings`

## Request

- Base URL: `https://macfax.com`
- URL: `https://macfax.com/api/v1/listings`
- Auth: one of:
  - none
  - HTTP bearer
  - API key in header `X-Api-Key`
  - API key in query parameter `api_key`

Quality-gated live listings aggregated from eBay, Craigslist, OfferUp, Swappa, Facebook and Reddit — scam clusters, junk titles, classified-ad bait, auctions and stale/sold rows are already filtered out. Every row deep-links to the source listing; the buyer completes the purchase there. Page depth is capped (offset ≤ 480) — this is a buying tool, not a bulk feed. Rate limits: 20/min and 500/day per anonymous IP; 200/min and 5000/day with a free key.

## Query parameters

- `config` string
- `family` string
- `chip_tier` string
- `year` integer
- `ram_gb` integer
- `storage_gb` integer
- `max_price_usd` integer
- `min_tier` 'listed' | 'free' | 'premium'
- `sort` 'fresh' | 'price_asc' | 'price_desc'
- `limit` integer
- `offset` integer

## Response `200`

Listings + page info.

## Other responses

- `400`: Bad filter or page depth over the cap.
- `429`: Rate limited.

---

[API](https://skmtc.dev/macfax/apis/macfax-api.md) · [All operations](https://skmtc.dev/macfax/apis/macfax-api/llms.txt) · [OpenAPI document](https://skmtc.dev/macfax/apis/macfax-api/revisions/ce892dbbd7d5?raw)