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

> Returns one Gumtree listing: title, description, price, images, category, location with coordinates, seller name, and the seller ids needed for GET /v1/gumtree/seller. Pass the numeric ad id or the full gumtree.com/p/.../{id} URL. Asking prices, not sold prices. published_at is not returned because Gumtree only exposes relative age.

TL;DR: `GET /v1/gumtree/product` 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 |
| --- | --- | --- |
| `product_id` | no | Gumtree advertisement id, the numeric id at the end of a listing URL: gumtree.com/p/apple-iphone/iphone-11/1515115590 is ad id 1515115590. Ad ids also come back on every row of GET /v1/gumtree/search. |
| `url` | no | Full Gumtree listing URL, for example https://www.gumtree.com/p/apple-iphone/iphone-11-11-pro-11-pro-max-unlocked-with-warranty/1515115590. The ad id is extracted from the path. |

## Code example

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

## FAQ

### What does the Gumtree Product API return?

Returns one Gumtree listing by ad id or URL: title, description, price, images, category, location, seller name, and the seller ids needed for seller lookups. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields.

### When should I use the Gumtree Product endpoint?

Use it when you already have an ad id or a gumtree.com/p listing URL. Search first if you only have a keyword.

### How much does the Gumtree Product API cost?

Each call costs 5 credits, so the 100 free credits every new account gets cover 20 calls. Credits for failed or empty calls are refunded automatically, and there is no subscription.

### What parameters does the Gumtree Product API need?

Identify the target with one of product_id, url. It also accepts 2 optional parameters, all listed on this page.

### How do I call the Gumtree Product API?

Send a GET request to https://www.socialcrawl.dev/v1/gumtree/product?product_id=1515115590 with your API key in the x-api-key header. An Authorization: Bearer header works too.

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

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- What does the SocialCrawl Gumtree Product API return?
- How do I get Gumtree Product data with the SocialCrawl API?