---
title: "Check one listing before trusting it"
method: GET
path: "/api/v1/check-listing"
---

# Check one listing before trusting it

`GET /api/v1/check-listing`

## Request

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

"Should I trust this listing?" — pass the listing URL (or a Macfax listing id) and get: whether Macfax knows it, whether it still passes every quality gate, its scam/junk/classified/auction flags, when a scan last verified it live, its ask against the configuration's typical asking band, the platform's own seller-reputation figures where the marketplace has them (seller_signals: eBay feedback count/percent, Swappa rating; null elsewhere — Craigslist has no seller reputation to read), and whether a verified Macfax report is attached. Facts, not verdicts — relay the numbers. Human twin: https://macfax.com/listing-check. Rate limits: 20/min and 500/day per anonymous IP; 200/min and 5000/day with a free key.

## Query parameters

- `url` string
- `id` string

## Response `200`

Check result; known:false when Macfax hasn't indexed the listing.

## Other responses

- `400`: Neither url nor id supplied.
- `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)