# Gumtree Data API (https://www.socialcrawl.dev/platforms/gumtree)

> The SocialCrawl Gumtree API turns Gumtree UK classifieds into JSON across 11 endpoints. Search returns about 22 ads per page with ad id, title, GBP price, location, category and seller type. Product returns the full listing, seller and seller/listings cover public seller profiles and stock, and trending, categories, filters and locations supply the reference data search needs.

TL;DR: SocialCrawl's Gumtree API exposes 11 endpoints, 1 to 5 credits per call, all returning one unified JSON schema with computed fields such as engagement rate, language and content category. Single x-api-key auth, 100 free credits on signup.

## Endpoints

| Endpoint | Method | Path | Credits | Description |
| --- | --- | --- | --- | --- |
| Search | GET | `/v1/gumtree/search` | 5 | Search Gumtree UK listings |
| Product | GET | `/v1/gumtree/product` | 5 | Get a Gumtree listing by ad id or URL |
| Product Similar | GET | `/v1/gumtree/product/similar` | 5 | Get listings similar to a Gumtree ad |
| Seller | GET | `/v1/gumtree/seller` | 5 | Get a Gumtree seller profile |
| Seller Listings | GET | `/v1/gumtree/seller/listings` | 5 | List a Gumtree seller's active ads |
| Search Suggestions | GET | `/v1/gumtree/search/suggestions` | 5 | Get Gumtree search suggestions |
| Trending | GET | `/v1/gumtree/trending` | 1 | Get trending Gumtree searches |
| Categories | GET | `/v1/gumtree/categories` | 1 | Get the Gumtree category tree |
| Filters | GET | `/v1/gumtree/filters` | 1 | Get Gumtree filters for a category |
| Locations | GET | `/v1/gumtree/locations` | 5 | Autocomplete Gumtree locations |
| Locations Nearest | GET | `/v1/gumtree/locations/nearest` | 5 | Find the nearest Gumtree location |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/gumtree/search" \
  --data-urlencode "query=iphone" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

Every response shares one JSON envelope: `{ success, platform, endpoint, data, credits_used, credits_remaining }`.

## FAQ

### What can I scrape from Gumtree with SocialCrawl?

You can pull Gumtree UK ad search results, full listings with description, images, category, location and seller name, public seller profiles, a seller's active ads, similar ads, search suggestions and trending searches. Categories, filters and locations return the ids that search filters take. Everything comes back as JSON from one API key.

### How do I filter Gumtree search by category, condition or mileage?

Pass a category_id from categories or search/suggestions, then look up that category's filter names with filters and send them as attributes, for example common_for_sale_condition:new,vehicle_make:audi. min_price, max_price, seller_type and attributes only take effect when category_id is set.

### Can I search Gumtree ads near a postcode?

Yes, locations turns a place name or postcode into a location_id, and locations/nearest does the same for a latitude,longitude pair. Pass that location_id to search with a distance in miles, or use nationwide to search the whole UK.

### Can I reuse a Gumtree search URL I already have?

Yes, pass a gumtree.com/search URL as url and the keyword, category, location and price filters on it are parsed for you. Location slugs default to a 15-mile radius unless the URL carries a distance.

### How do I look up a Gumtree seller and their other ads?

A product response carries the seller's user_id and public_user_id. Pass both, as seller_id and public_id, to seller for the display name, rating and membership caption, and to seller/listings for their active ads, about 20 per page. A seller that no longer exists returns a 404.

### Does the Gumtree API cover countries outside the UK?

No, it covers Gumtree UK. Asking prices come back in GBP and search distances are in miles. Credits for failed or empty calls are refunded automatically.

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I scrape Gumtree UK listings with the SocialCrawl API?
- Can SocialCrawl search Gumtree ads near a UK postcode?
- Is there a Gumtree API for seller profiles and trending searches? Does SocialCrawl have one?