telgani.com APItelgani.com ↗
Search rental cars, filter by city, brand, and type, and retrieve special offers or subscription plans from Telgani via a structured JSON API.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/66a421a8-3fec-45c8-832b-044ee3934130/list_cities' \ -H 'X-API-Key: $PARSE_API_KEY'
Get all available cities/locations where car rental is offered on Telgani. Returns city names, coordinates, and slugs.
No input parameters required.
{
"type": "object",
"fields": {
"cities": "array of city objects with id, name, slug, latitude, longitude, and address"
},
"sample": {
"data": {
"cities": [
{
"id": "843935b3-653f-11eb-a589-0a65d7c593f2",
"name": "Rent a Car in Riyadh",
"slug": "city/riyadh",
"address": "Riyadh Saudi Arabia",
"latitude": 24.7135517,
"longitude": 46.67529569999999
}
]
},
"status": "success"
}
}About the telgani.com API
The Telgani API exposes 6 endpoints covering car rental search, city listings, brand and type catalogs, special offers, and subscription plans on telgani.com. The search_cars endpoint accepts latitude/longitude or city name along with pickup and drop-off dates, returning car objects with pricing, office info, and installment data. Lookup endpoints like list_cities and list_car_brands provide the reference data needed to build filters.
Reference Data Endpoints
list_cities returns an array of city objects, each with an id, name, slug, latitude, longitude, and address — enough to populate a location picker or map. list_car_brands and list_car_types return lightweight arrays of id and name pairs covering all manufacturers and categories (such as SUV, Economy, or Sedan) available on the platform. These three endpoints require no input parameters.
Car Search and Filtering
search_cars is the primary query endpoint. It accepts optional lat/lng coordinates or a city_name string, plus pickup_date and drop_date in YYYY-MM-DD format. If dates are omitted, the endpoint defaults to tomorrow and the day after. The limit parameter controls how many results are returned, and the endpoint paginates internally up to that ceiling. Each car object in the cars array includes rental details, pricing, office information, subscription terms, and installment data. The total field reflects the full count of matched cars.
Offers and Subscriptions
get_special_offers returns cars where discount_price is lower than the regular price — useful for surfacing active promotions without building custom price comparison logic. search_cars_subscription filters for vehicles available on monthly or yearly plans and returns subscription pricing segmented by duration: 1, 3, 6, 9, and 12 months. It accepts an optional city_name to narrow results geographically.
- Build a city-aware car rental search UI using
list_citiescoordinates andsearch_carsdate filters - Display a live deals section by polling
get_special_offersfor cars with active discount prices - Compare long-term car costs across cities using the 1, 3, 6, 9, and 12-month tiers from
search_cars_subscription - Populate brand and category filter dropdowns from
list_car_brandsandlist_car_types - Calculate installment-based monthly spend from the installment data field returned in car objects
- Map rental office locations using office info returned in
search_carscar objects - Alert users to expiring offers by tracking discount prices from
get_special_offersover time
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Telgani have an official developer API?+
What does `search_cars` return for each car, and can I filter by brand or car type?+
list_car_brands and type IDs from list_car_types, then filter the returned cars array client-side. You can fork this API on Parse and revise it to add server-side brand and type filtering if needed.What happens if I omit both `city_name` and coordinates in `search_cars`?+
city_name nor lat/lng are provided, the endpoint falls back to the platform's default city. For predictable results, supply either a city name from list_cities or coordinates from that same endpoint.Does the API return car images, vehicle specifications, or reviews?+
search_cars, get_special_offers, and search_cars_subscription include rental and pricing data, office info, subscription plans, and installment data. Detailed vehicle specifications, individual listing images, and user reviews are not currently exposed as discrete fields. You can fork this API on Parse and revise it to add endpoints that surface those additional details.Is subscription pricing available for all cities, or only specific ones?+
search_cars_subscription accepts an optional city_name parameter. If omitted, it returns subscription-eligible cars for the platform's default city. Coverage depends on which listings on Telgani have active subscription plans configured — not all cities or car types may have subscription options available at a given time.