> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/gumtree/locations>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/gumtree/locations.mdx>

---

# Gumtree Locations API

Turn typed text into Gumtree places, postcode districts and postcodes.

`GET /v1/gumtree/locations?query=manch` returns `data.locations`, best first, each with `id`, `name`, `type` (`location`, `outcode` or `postcode`), `city`, `latitude` and `longitude` of its centre.

Use the `id` as the `locationId` of trending searches and location areas, and a place's slug from location areas or a postcode as the `location` of a search. Text that matches nothing returns an empty list.

## Request

- **Endpoint:** `GET /v1/gumtree/locations`
- **Credits:** 1 credit
Failed requests are free
Found, empty and not-found answers are all charged
- **Input:** by place name or postcode
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/gumtree/locations/get)
- **Platform page:** [/platforms/gumtree](https://www.socialfetch.dev/platforms/gumtree)

## FAQ

### Can I look up a postcode?

Yes. A full postcode such as SW1A 1AA returns one postcode result, and a district such as M1 returns an outcode result.

### Is there a nearest-location lookup from coordinates?

No. Gumtree offers no lookup from coordinates; search by place name or postcode instead.

### How many results come back?

The few the site offers for the text, best first.

### How many credits does a request cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
