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

> Returns Gumtree UK classifieds matching a keyword, about 22 per page, each with ad id, title, price in GBP, location, category, seller type (private or trade), image, and listing URL. Pass a gumtree.com/search URL as url to replay an existing web search (location slugs default to a 15-mile radius unless the URL carries a distance). Price, seller_type, and attributes filters only apply when category_id is also set. Paginate with page or the universal cursor until hasNextPage is false. Feed a returned ad id into GET /v1/gumtree/product for the full listing.

TL;DR: `GET /v1/gumtree/search` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | no | Free-text listing search, for example iphone or golf mk7 diesel. |
| `url` | no | A Gumtree web search URL, for example https://www.gumtree.com/search?q=iphone&search_location=london. Keyword, category, location, and price filters on the URL are parsed server-side. |
| `page` | no | Page number, starting at 1. Prefer the universal cursor parameter. |
| `sort_by` | no | Result ordering: relevance (default), newest, price_low, or price_high. (relevance \| newest \| price_low \| price_high) |
| `category_id` | no | Gumtree category id or SEO slug from GET /v1/gumtree/categories or search/suggestions. Required for price, seller_type, and attributes filters to take effect. |
| `location_id` | no | Gumtree location id from GET /v1/gumtree/locations or locations/nearest. |
| `distance` | no | Search radius in miles around location_id. Ignored without a location_id. nationwide searches the whole UK. (0 \| 1 \| 3 \| 5 \| 10 \| 15 \| 30 \| 50 \| 75 \| 100 \| 150 \| 250 \| 500 \| nationwide) |
| `min_price` | no | Lowest asking price in GBP. Requires category_id. Filter on product.price.current if you need a hard bound. |
| `max_price` | no | Highest asking price in GBP. Requires category_id. |
| `seller_type` | no | Restrict to private (individual) or trade (dealer) sellers. Requires category_id. (private \| trade) |
| `attributes` | no | Category-specific filters as comma-separated name:value pairs from GET /v1/gumtree/filters, for example common_for_sale_condition:new,vehicle_make:audi. Requires category_id. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/gumtree/search" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

See the full Gumtree API: https://www.socialcrawl.dev/platforms/gumtree

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