# StreetEasy listing: `POST /v1/streeteasy/listing`

Cost: 2 credits (2 (an unknown listing and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/streeteasy-listing

`url` is one listing link. A unit listing is `/building/<slug>/<unit>` (for example `/building/solace/ph16`). A house or townhouse is `/building/<slug>/sale/<id>` or `/building/<slug>/rental/<id>`. Pass the `url` from a search row. An unknown listing is HTTP 404 and is not charged. A block is HTTP 503 with `Retry-After` and is not charged.

Everything StreetEasy publishes about one listing.

Price (with net-effective rent, or taxes, common charges and the
estimated monthly payment for a sale), the full description, rooms,
amenities and features, photos, status and price history, days on
market, the building and the listing office as published. An
unknown listing is a 404 and is not charged.

Request body (JSON):

- `url` (string; required; max length 500): A StreetEasy listing link, as in a search result's url.

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
