{"uid":"cap_hAyb6_V51_ffpI1qntsVU","slug":"cargurus-used-car-listings-scraper-4940431c","name":"CarGurus Used Car Listings Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/cargurus?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"zip":{"type":"string","description":"Location for filter-based search, such as 10001, M4B 1B4, or SW1A 1AA."},"distance":{"type":"integer","default":50,"minimum":1,"description":"Search radius in local distance units."},"maxItems":{"type":"integer","default":100,"minimum":0,"description":"Stop after this many listings across all searches. Set 0 for no item cap."},"maxPages":{"type":"integer","default":0,"minimum":0,"description":"Stop after this many result pages per search. Set 0 for all available pages."},"sortType":{"enum":["BEST_MATCH","DEAL_SCORE","PRICE","MILEAGE","YEAR","DISTANCE","LISTING_DATE"],"type":"string","default":"BEST_MATCH","description":"Order search results by this criterion."},"startUrls":{"type":"array","description":"Optional CarGurus search URLs on the US, Canada, or UK site. If supplied, these replace the location filters."},"searchCountry":{"enum":["US","CA","UK"],"type":"string","default":"US","description":"Marketplace used when no search URL is provided."},"sortDirection":{"enum":["ASC","DESC"],"type":"string","default":"ASC","description":"Ascending or descending order for the selected sort criterion."},"makeModelTrimPaths":{"type":"string","description":"Optional path copied from a filtered search URL, such as m4 or m124,m124/d1751."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"make":null,"trim":null,"year":null,"model":null,"title":null,"country":null,"bodyType":null,"listingId":null}],"product":"cargurus"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_bt5_FRWmL-zSNYwbEtFUr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes structured used car listing data from CarGurus by location, make/model, price, and other filters across US, Canada, and UK markets","exampleAgentPrompt":"Search CarGurus for used Honda Accord listings within 50 miles of 90210 in the US, sorted by price ascending, and give me up to 100 results.","exampleUseCases":[{"title":"Find affordable used SUVs nearby","prompt":"Pull me CarGurus listings for used Toyota RAV4s within 30 miles of zip code 10001 in the US, sorted by lowest price first, up to 50 results."},{"title":"Monitor best deals on a specific trim","prompt":"Search CarGurus for Ford F-150 XLT trim listings near M4B 1B4 in Canada, sorted by deal score descending, and return the top 25 listings."},{"title":"Analyze inventory from a CarGurus search URL","prompt":"Scrape the car listings from this CarGurus URL — https://www.cargurus.com/Cars/new/nl_Tesla_Model_3 — and give me up to 200 results with all available details."}],"resultDescription":"Returns a JSON object containing the total count of matched listings, the product identifier ('cargurus'), and an array of listing items each with fields for listing ID, make, model, trim, year, title, body type, and country.","failureModes":["Empty result set if no listings match the filters (not charged)","Invalid zip code format returns error or empty results","Unsupported search URL domain or format returns error","maxItems or maxPages set to values that conflict with available data","CarGurus site changes breaking scraper schema","Network timeout on large page counts"],"whenToPreferThis":"Use this endpoint when you need structured CarGurus vehicle listing data — especially when filtering by location, make/model/trim, sort order, or directly from a CarGurus search URL — across US, Canadian, or UK markets. Prefer it over general web scrapers for CarGurus-specific structured output with pay-per-success pricing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:42.541Z","isFirstParty":false,"canonicalSlug":"cargurus-used-car-listings-scraper-4940431c"}