---
title: "Gumtree API: JSON data, 5 endpoints, 1 credit per call"
description: "Get Gumtree data as structured JSON with one API key: search, listing, location and autocomplete. Free credits every month."
url: https://perceptlayer.com/apis/gumtree
---

[APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / Gumtree

1 credit per call 5 endpoints

# Gumtree API

Get Gumtree data as structured JSON with one API key: search, listing, location and autocomplete. Free credits every month.

[Get a free API key](https://perceptlayer.com/signup) Run it below

Gumtree

GET /v1/gumtree/search?query=bike&category\_id=86 

```
curl "https://api.perceptlayer.com/v1/gumtree/search?query=bike&category_id=86" \
  -H "X-API-Key: $API_KEY"
```

cURL 1 credit per successful call

Run this call below or from your dashboard to see a live response.

Playground

## Run this API

cURL shell 

```
curl "https://api.perceptlayer.com/v1/gumtree/search?query=bike&category_id=86" \
  -H "X-API-Key: $API_KEY"
```

Gumtree · 5 endpoints

## Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

| Endpoint | Required parameters | Cost |
| --- | --- | --- |
| [GET `/v1/gumtree/autocomplete`](https://perceptlayer.com/apis/gumtree/autocomplete) | `query` | 1 credit |
| [GET `/v1/gumtree/categories`](https://perceptlayer.com/apis/gumtree/categories) | none | 1 credit |
| [GET `/v1/gumtree/listing`](https://perceptlayer.com/apis/gumtree/listing) | `id` | 1 credit |
| [GET `/v1/gumtree/location`](https://perceptlayer.com/apis/gumtree/location) | `latitude` `longitude` | 1 credit |
| [GET `/v1/gumtree/search`](https://perceptlayer.com/apis/gumtree/search) | none +10 optional | 1 credit |

Overview

## About the Gumtree API

## What you can get

The Gumtree API returns search, listing, location and autocomplete as clean JSON. Each successful call costs one credit, and calls that fail are free.

Marketplaces JSON REST MCP

### More marketplaces APIs

[AliExpress](https://perceptlayer.com/apis/aliexpress) [Billiger.de](https://perceptlayer.com/apis/billiger) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) [Depop](https://perceptlayer.com/apis/depop) [Dubizzle](https://perceptlayer.com/apis/dubizzle) [eBay](https://perceptlayer.com/apis/ebay) [FINN](https://perceptlayer.com/apis/finn) [Geizhals](https://perceptlayer.com/apis/geizhals) [Idealo](https://perceptlayer.com/apis/idealo) [Kijiji](https://perceptlayer.com/apis/kijiji) [Kleinanzeigen](https://perceptlayer.com/apis/kleinanzeigen)

Use cases

### Track competitor prices and stock

`Use the Gumtree API to track competitor prices and stock` 

### Enrich your product catalogue

`Use the Gumtree API to enrich your product catalogue` 

### Research sellers and categories

`Use the Gumtree API to research sellers and categories` 

FAQ

## Questions

**How much does the Gumtree API cost?**

Each successful call costs one credit. New accounts get free credits every month, and credit packs bring the price down as you scale.

**What format are responses in?**

Every endpoint returns JSON, with no HTML parsing on your side.

**Do I need a separate key for Gumtree?**

No. One key works for every API in the catalogue.

## Try the Gumtree API with 1,000 free credits

No credit card. Failed calls are never billed.

[Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://perceptlayer.com/docs)