100 free credits. No credit card required.Start building
Logo
Gumtree logo
100 free credits. No credit card required

Gumtree Scraper API

Access 11 Gumtree API endpoints through one unified interface for profiles, posts, comments, search, and more. When an endpoint supports a computed field and the required source inputs are present, that optional field is included in the unified response.

TL;DR

The Gumtree API by SocialCrawl returns Gumtree data as structured JSON: 11 endpoints behind one x-api-key, from 1 credit per call. It shares one unified schema with 59 other platforms, so the same client code works everywhere.

Live demo

Try the Gumtree API in your browser

Type a real handle, run a real request, see the JSON SocialCrawl returns. No signup, no key. Same response shape you get in production.

Returns Gumtree UK classifieds matching a keyword or a gumtree.com/search URL, about 22 per page, each with ad id, title, GBP price, location, category, seller type, and listing URL.

Use it to find UK second-hand, vehicle, or property ads by keyword. Feed a returned ad id into product for the full listing.

Try the Gumtree Search API

See real data before writing a single line

GET/v1/gumtree/search
11 optional parameters

Free-text listing search, for example iphone or golf mk7 diesel.

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 number, starting at 1. Prefer the universal cursor parameter.

Result ordering: relevance (default), newest, price_low, or price_high.

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.

Gumtree location id from GET /v1/gumtree/locations or locations/nearest.

Search radius in miles around location_id. Ignored without a location_id. nationwide searches the whole UK.

Lowest asking price in GBP. Requires category_id. Filter on product.price.current if you need a hard bound.

Highest asking price in GBP. Requires category_id.

Restrict to private (individual) or trade (dealer) sellers. Requires category_id.

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.

Endpoints

What data does the Gumtree API return?

Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.

Last updated September 2026

Maintained by the SocialCrawl team, reviewed September 2026

Searchadvanced

Search Gumtree UK listings

Productadvanced

Get a Gumtree listing by ad id or URL

Product Similaradvanced

Get listings similar to a Gumtree ad

Selleradvanced

Get a Gumtree seller profile

Seller Listingsadvanced

List a Gumtree seller's active ads

Search Suggestionsadvanced

Get Gumtree search suggestions

Trendingstandard

Get trending Gumtree searches

Categoriesstandard

Get the Gumtree category tree

Filtersstandard

Get Gumtree filters for a category

Locationsadvanced

Autocomplete Gumtree locations

Locations Nearestadvanced

Find the nearest Gumtree location

What you get

What Gumtree data can you get?

Every Gumtree endpoint uses the same response envelope, so one parser handles the whole platform. These are fields returned by current public responses, subject to each endpoint's documented cache window.

Fields you get back in a Gumtree response include:

  • title
  • url
  • description
  • engagement_rate_percentages
  • recent_posts
  • followers
  • comments
  • likes
  • recent_posts_explanation
  • id_user
  • username
  • is_private
  • posts_details
Quickstart

How to scrape Gumtree in 3 steps

No proxies, no headless browsers, no login sessions. Send one authenticated GET request and read structured JSON back.

  1. 1

    Get a free API key

    Create an account and copy your key from the dashboard. Signup includes 100 free credits, and no card is required.

  2. 2

    Call the Search endpoint

    Send a GET request with your key in the x-api-key header. Here is the full Gumtree Search request:

    curl -H "x-api-key: YOUR_API_KEY" \
      "https://www.socialcrawl.dev/v1/gumtree/search"
  3. 3

    Read the unified JSON

    The response comes back in the shared SocialCrawl schema. Where the endpoint supports them and the required source inputs are present, fields such as engagement_rate and content_category are filled in too. Your client can rely on the shared envelope while treating enriched fields as optional.

Requirements and limits

Requirements and limits

Everything you need to know before your first Gumtree call.

Authentication
One API key, passed in the x-api-key request header. No OAuth flow, no app review, and no per-platform credentials to manage.
Pagination
List endpoints return a next_cursor and a has_more flag. Pass the cursor back to page through results, with the same contract on every platform.
Credits
Calls start at 1 credits and are deducted per request. Every account starts with 100 free credits, and credits never expire.
Rate limits
Two ceilings, both per API key and identical on every plan: 600 requests per minute and 50 simultaneous requests. Neither costs you a credit when it rejects a request, and past them your credit balance is the only throttle.
Pricing

How much does the Gumtree API cost?

Simple credit-based pricing with no subscription. You pay per call, and the exact credit cost of every Gumtree endpoint is listed below.

EndpointCredits per call
Search5 credits
Product5 credits
Product Similar5 credits
Seller5 credits
Seller Listings5 credits
Search Suggestions5 credits
Trending1 credit
Categories1 credit
Filters1 credit
Locations5 credits
Locations Nearest5 credits

Every account starts with 100 free credits, and no card is required.

At credit-pack pricing that works out to roughly £0.002 to £0.03 per call, and credits never expire.

Developer First

How do you scrape social media data in seconds?

The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 60 platforms covering 10B+ monthly active users.

One schema, every platform

Query 60 platforms with identical response structures. Write your integration once.

Computed fields, not just scraped

When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.

See your data before you code

Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.

import requests

response = requests.get(
    'https://www.socialcrawl.dev/v1/tiktok/profile',
    params={'handle': 'charlidamelio'},
    headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()
[ .JSON ]
{
  "success": true,
  "platform": "tiktok",
  "data": {
    "author": {
      "username": "charlidamelio",
      "followers": 152400000
    },
    "engagement": {
      "likes": 12400000000,
      "engagement_rate": 0.087
    },
    "metadata": {
      "language": "en",
      "content_category": "lifestyle"
    }
  }
}
+ 60 platforms
One API, 60 platforms

How does SocialCrawl handle 60 different platforms?

Social media scraping is hard. Schema normalization, authentication, rate limits, pagination. We handle all of it before your data arrives.

One schema, every platform

Write once, query them all.

60 platforms return 60 different JSON shapes. We normalize every response into one consistent structure.

Ready-to-use metrics

Metrics ready before you ask.

Normalized records include supported metrics such as engagement rate, estimated reach, content category, and language when the required source inputs are available.

Consistent pagination

One cursor, every platform.

Every platform paginates differently. We give you one consistent cursor-based system.

Freshness you control

Fresh when it matters. Free on repeat.

Cache misses fetch current public data. Identical requests are cached for 2 to 30 minutes by data type and cost 0 credits on a hit; send Cache-Control: no-cache for a billed refresh.

Things you'll never build

Auth, proxies, and rate limits, handled

Platform authentication, IP rotation, and rate limit management are all abstracted away. Just send a GET request.

Start for free
Reviews

What developers say

Rated 4.9 out of 5 from 200 developer reviews
The unified schema saved us weeks of integration work. One parser handles every platform.
Alex Chen, Full-Stack Developer
Our agents process social data from 60 platforms with zero platform-specific logic. One schema, end to end.
Sarah Kim, AI Engineer, AgentFlow
I paste an influencer's URL and get everything (followers, engagement rate, content categories) without touching code.
James Rivera, Marketing Director
We switched from building our own scrapers. SocialCrawl handles the hard stuff, we focus on insights.
Maria Santos, CTO, DataPulse
The computed fields alone (engagement_rate, estimated_reach, content_category) saved us an entire data pipeline.
David Park, Lead Data Scientist
Quick answers

How much does Gumtree scraping cost?

SocialCrawl uses credit-based pricing: you pay per API call, and most Gumtree endpoints cost just a few credits. Every account starts with 100 free credits. No subscriptions, no compute units, no credit card required.

See pricing

Is Gumtree scraping legal?

SocialCrawl returns publicly available Gumtree data. Courts have generally upheld scraping public data, most notably in hiQ v. LinkedIn, but compliance depends on your use case and jurisdiction. You are responsible for following applicable laws and platform terms.

Glossary

Common Gumtree scraping terms

The phrases developers search for when they need Gumtree data, and what each one means with SocialCrawl.

Gumtree scraper API
A Gumtree scraper API returns Gumtree data as structured JSON without you running any scraping infrastructure. SocialCrawl handles the proxies, parsing, and format changes, so you call an endpoint and get clean fields back. Pricing starts at 1 credits per call.
Gumtree data API
A Gumtree data API is a programmatic way to read public Gumtree data on demand. SocialCrawl exposes 11 Gumtree endpoints behind one x-api-key, all sharing the same unified schema, so your integration never has to change per platform.
scrape Gumtree
To scrape Gumtree is to extract its public data programmatically instead of by hand. With SocialCrawl you scrape Gumtree by sending a single authenticated request, and the response is normalised into the same JSON shape used across every platform.
Read the full API reference
FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

Contact us
How much does the Gumtree API cost?
Gumtree endpoints are billed per call in credits: standard endpoints cost 1 credit, advanced 5, and premium 10. On Gumtree that works out to between 1 and 5 credits per call. Every account starts with 100 free credits, and there is no subscription. You only pay for the calls you make.
Is scraping Gumtree data legal?
SocialCrawl returns publicly available Gumtree data and does not access private or login-gated content. Whether scraping fits your project depends on your use case and jurisdiction. You are responsible for complying with Gumtree's terms of service and applicable data-protection laws such as GDPR and CCPA. This is general information, not legal advice.
Gumtree scraping API vs the official Gumtree API: what's the difference?
With SocialCrawl there is no app review or approval queue. Sign up and call Gumtree endpoints immediately with a single x-api-key. Responses share one unified schema with every other SocialCrawl platform, and credit-based pricing replaces per-platform quotas. Official APIs are still the right choice for posting and other write actions: SocialCrawl is read-only data.

Ready to start scraping Gumtree data?

Get your API key and access all 11 Gumtree endpoints in under 60 seconds.

Start for free

🤖 AI agent or LLM? Read this page as markdown