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

> Access Gumtree data through 11 API endpoints. Profiles, posts, comments, search, and more. Unified schema, AI-enriched. Free trial.

TL;DR: SocialCrawl's Gumtree API exposes 11 endpoints, 1 to 5 credits per call, all returning one unified JSON schema with AI-enriched fields. 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 "https://www.socialcrawl.dev/v1/gumtree/search" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

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

## 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