google-maps-scraper-cycletls

Node.js library that queries Google Maps (tbm=map) search and returns a list of places. Uses CycleTLS for TLS/HTTP2 fingerprinting.

Installation

npm install google-maps-scraper-cycletls

Usage

const { searchPlaces, setFetchSettings } = require('google-maps-scraper-cycletls');

// Optional: cookie, proxy, timeout
setFetchSettings({ proxy: 'http://user:pass@host:port' });

const result = await searchPlaces(
  { q: 'restaurant kadikoy', hl: 'en', gl: 'tr' },
  { cookieString: '...' }
);

console.log(result.status); // 200
console.log(result.data);   // Place[]

API

• searchPlaces(query, options?) – Runs a search and returns { status, query, data: Place[], rawBody, parsed }.
• setFetchSettings({ userAgent?, ja3?, http2Fingerprint?, proxy? }) – Updates fetch settings (fingerprint, proxy, etc.).
• buildMapsUrl(params), fetchGoogleMaps(url, options), parseGoogleMapsResponse(body), parsePlacesFromDecodedBody(data) – Lower-level helpers.

Requirements

• Node.js >= 18
• cycletls (installed as a dependency)

License

ISC