📖 API Documentation

Complete reference for the Places API Proxy endpoints

🔐 Authentication

Include your API key in every request using one of these methods:

Option 1: Bearer Token (recommended)

Authorization: Bearer YOUR_API_KEY

Option 2: Query Parameter

?key=YOUR_API_KEY

🔌 Endpoints

Base URL: https://places.abhibots.com

Place Details

GET /api/place/details

Get detailed information about a specific place.

Param	Required	Description
`place_id`	Yes	Google Place ID
`fields`	No	Comma-separated fields (name,rating,formatted_phone_number,website,opening_hours,reviews,photos)
`language`	No	Language code (en, hi, etc.)

curl "https://places.abhibots.com/api/place/details?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name,rating,formatted_phone_number" \
  -H "Authorization: Bearer YOUR_KEY"

Text Search

GET /api/place/textsearch

Search for places using a text query.

Param	Required	Description
`query`	Yes	Search query (e.g., "restaurants in Delhi")
`location`	No	lat,lng (e.g., "28.6139,77.2090")
`radius`	No	Search radius in meters
`type`	No	Place type filter

curl "https://places.abhibots.com/api/place/textsearch?query=restaurants+in+Delhi" \
  -H "Authorization: Bearer YOUR_KEY"

Nearby Search

GET /api/place/nearbysearch

Param	Required	Description
`location`	Yes	lat,lng
`radius`	Yes	Radius in meters (max 50000)
`type`	No	Place type (restaurant, hospital, etc.)
`keyword`	No	Keyword filter

Autocomplete

GET /api/place/autocomplete

Param	Required	Description
`input`	Yes	Text to autocomplete
`types`	No	Type filter (geocode, address, establishment)
`components`	No	Country filter (country:in)

Find Place

GET /api/place/findplacefromtext

Param	Required	Description
`input`	Yes	Place name or phone
`inputtype`	Yes	textquery or phonenumber
`fields`	No	Response fields

Place Photos

GET /api/place/photo

Param	Required	Description
`photo_reference`	Yes	Photo reference from place details
`maxwidth`	Yes*	Max width in pixels
`maxheight`	Yes*	Max height (* one of maxwidth/maxheight required)

Geocoding

GET /api/geocode

Param	Required	Description
`address`	Yes*	Address to geocode
`latlng`	Yes*	Reverse geocode (* one of address/latlng required)

📊 Rate Limits

Tier	Daily	Per Minute	Price
Free	50	10	₹0
Starter	500	60	₹499/mo
Pro	2,000	120	₹1,499/mo
Business	10,000	300	₹3,999/mo

⚡ Response Headers

Header	Description
`X-Cache`	HIT or MISS — whether response was cached
`X-Response-Time`	Server response time in ms

❌ Error Codes

Code	Meaning
401	Missing or invalid API key
403	Key disabled or expired
429	Rate limit exceeded
502	Upstream Google API error
503	Service at capacity

💬 Support

Contact @flyingabhi on Telegram for API keys, upgrades, and support.