Skip to content

docs(gumtree): South Africa ids are gumtree.co.za refs now (SCR-295) - #98

Merged
0xGhostCasper merged 1 commit into
mainfrom
scr-295-gumtree-za-refs
Oct 13, 2026
Merged

0xGhostCasper merged 1 commit into
mainfrom
scr-295-gumtree-za-refs

Conversation

@0xGhostCasper

Copy link
Copy Markdown
Member

Why

gumtree.co.za replaced its old site with a new Nuxt app on 2026-10-12. The numeric category and location ids (9077, 3100003, root 0 / 201) and the 26-digit listing ids are gone; everything is a short ref now. The API's za market was rebuilt on the site's new JSON API in scrape-badger/scrapebadger#2461 (deployed, all gumtree probes 200).

What changed (za only)

  • Ids are refs: p6dnh Cars & Bakkies, l4dq6 Vehicles, dkp8y Gauteng, gsptp South Africa root, kyzkk category root, listing ls26bvmcpnsqmz7l9jz.
    • parent_id is documented as a string.
    • Id fields are integer | string (integers stay integers on uk/au).
    • On za, /search takes the tree node's id, not its slug.
  • Filter keys are the site's own: make, model, bodyType, driveType, transmission, fuelType, colour, plus the ranges year and mileageKm. The old ma: / fu: / max_km / cy keys are gone.
  • Paging: za pages through the first 375 matches (19 pages); total_results keeps the full count.
  • No longer returned on za: phone numbers, short_id, lifetime_listings / total_views.
  • Now returned on za:
    • seller member_since_year and verification checks
    • location autocomplete coordinates
    • seller-listings totals
    • price_type values ASKING_PRICE / POA
  • Examples: every za request and response example was re-captured from the live API on 2026-10-13, and each example query returns results.

Pages: gumtree/overview.mdx and api-reference/endpoint/gumtree/{search, search-filters, get-listing, get-seller-listings, list-categories, list-locations, autocomplete, location-autocomplete, list-markets}.mdx.

uk and au content is unchanged. No Credit Costs table touched: scripts/check_credit_costs.py passes locally. mint broken-links reports no gumtree issues; its 4 broken links are on pre-existing facebook, google and twitter-streams pages.

Linear: SCR-295

🤖 Generated with Claude Code

gumtree.co.za re-platformed on 2026-10-12: numeric category/location ids and
26-digit listing ids are gone, replaced by refs ('p6dnh' Cars & Bakkies,
'dkp8y' Gauteng, 'ls26bvmcpnsqmz7l9jz' a listing). The API now serves the za
market from the site's new JSON API (scrapebadger PR #2461).

- za category / location / listing ids are refs; id fields are integer | string
- za filter keys are the site's own (make, model, fuelType, year, mileageKm …)
- za pages through the first 375 matches (19 pages); total_results stays full
- za returns no phone number, no short_id, no lifetime listings / total views
- every za example re-captured from the live API on 2026-10-13

UK and AU content and every credit cost are unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@0xGhostCasper
0xGhostCasper merged commit 2d0a9e3 into main Oct 13, 2026
2 checks passed
@0xGhostCasper
0xGhostCasper deleted the scr-295-gumtree-za-refs branch October 13, 2026 18:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants