API Documentation

Maps

Google Maps Places (Keyword)

Search for business places on Google Maps by keyword and location (e.g., 'cafe' in 'Pune').

POST

/api/v1/google_maps_places_scraper_sync

Parameters

Field	Type	Required	Description
`search_string`	string	Yes	Type of business to search for
`location_query`	string	Yes	Location to search within
`max_crawled_place_per_search`	number	No	Max results to return (default 5)

Response fields

Field	Type	Description
`title`	string	Name of the business
`categoryName`	string	Primary category (e.g. Cafe)
`address`	string	Full formatted address
`city`	string	City location
`phone`	string	Business phone number
`totalScore`	number	Average Google rating (0-5)
`reviewsCount`	number	Total number of reviews
`website`	string	Business website URL
`url`	string	Direct Google Maps URL

Code

curl -X POST https://api.richapi.ai/api/v1/google_maps_places_scraper_sync \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "search_string": "cafe",
  "location_query": "Pune",
  "max_crawled_place_per_search": 5
}'

Try it

Google Maps Places (URL)

Scrape Google Maps places directly from a search results URL.

POST

/api/v1/google_maps_places_scraper_sync_using_url

Parameters

Field	Type	Required	Description
`url`	string	Yes	Google Maps search results URL
`max_crawled_place_per_search`	integer	No	Max places to return

Response fields

Field	Type	Description
`title`	string	Name of the business
`categoryName`	string	Primary category
`address`	string	Full formatted address
`totalScore`	number	Average rating
`reviewsCount`	number	Total review count
`url`	string	Direct Google Maps URL

Code

curl -X POST https://api.richapi.ai/api/v1/google_maps_places_scraper_sync_using_url \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://www.google.com/maps/search/coffee+shop/@40.7128,-74.0060,14z"
}'

Try it

Google Maps Reviews

Scrape reviews for a specific Google Maps place synchronously.

POST

/api/v1/google_maps_reviews_scraper_sync

Parameters

Field	Type	Required	Description
`start_url`	string	Yes	Google Maps place URL to scrape reviews for
`max_review`	integer	No	Maximum number of reviews to return
`review_sort`	string	No	Sort order: relevant, newest, highest_rating, lowest_rating

Response fields

Field	Type	Description
`text`	string	Full text of the review
`publishAt`	string	Review date (e.g. 2 weeks ago)
`stars`	number	Rating given by the reviewer (1-5)
`reviewerName`	string	Name of the reviewer
`reviewId`	string	Unique ID of the review

Code

curl -X POST https://api.richapi.ai/api/v1/google_maps_reviews_scraper_sync \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "start_url": "https://www.google.com/maps/place/Starbucks/@40.7128,-74.0060,17z",
  "max_review": 10
}'

Try it