Telgani APItelgani.com ↗
Access Telgani car rental data for Saudi Arabia: search cars by city and date, browse brands, types, special offers, and monthly subscription plans.
What is the Telgani API?
The Telgani API exposes 6 endpoints covering car rental inventory, pricing, and subscription plans across Saudi Arabia. Use search_cars to query available vehicles by city, coordinates, and date range — each result includes daily pricing, office details, and installment options. Companion endpoints cover cities with GPS coordinates, car brands, car types, discounted special offers, and monthly subscription pricing broken down by 1, 3, 6, 9, and 12-month durations.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace telgani-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Telgani Car Rental SDK — search, compare, and discover deals."""
from parse_apis.telgani_car_rental_api import Telgani, CityName, CityNotFound
client = Telgani()
# List available rental cities with coordinates
for city in client.cities.list(limit=5):
print(city.name, city.latitude, city.longitude)
# Browse car brands available on the platform
for brand in client.brands.list(limit=5):
print(brand.id, brand.name)
# Search for rental cars in Riyadh with dates
car = client.cars.search(city_name=CityName.RIYADH, pickup_date="2026-07-01", drop_date="2026-07-03", limit=1).first()
if car:
print(car.name, car.year, car.price, car.currency)
print(car.office.name, car.office.rating)
# Check special offers — discounted cars
for offer in client.cars.offers(limit=3):
print(offer.name, offer.price, offer.discount_price, offer.office.name)
# Explore subscription plans in Jeddah
try:
for sub_car in client.cars.subscriptions(city_name=CityName.JEDDAH, limit=3):
print(sub_car.name, sub_car.subscription.is_enabled, sub_car.subscription.prices)
except CityNotFound as exc:
print(f"City not available: {exc}")
print("exercised: cities.list / brands.list / cars.search / cars.offers / cars.subscriptions")Retrieve all cities and locations where Telgani offers car rental services. Each city includes coordinates and a slug for use in other endpoints. The full list is returned in a single response with no pagination.
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
},
{
"id": "84393908-653f-11eb-a589-0a65d7c593f2",
"name": "Rent a Car in Dammam",
"slug": "city/dammam",
"address": "Dammam Saudi Arabia",
"latitude": 26.4206828,
"longitude": 50.0887943
}
]
},
"status": "success"
}
}About the Telgani API
Coverage and Structure
The API covers Telgani's rental marketplace in Saudi Arabia. Three catalog endpoints — list_cities, list_car_brands, and list_car_types — return complete flat lists in a single response with no pagination. Cities include id, name, slug, latitude, longitude, and address fields, making it straightforward to feed coordinates directly into search endpoints. Brands and types return simple id/name pairs useful for filtering or display.
Searching for Rental Cars
search_cars is the core search endpoint. It accepts city_name, lat/lng coordinates, pickup_date, drop_date (both in YYYY-MM-DD format), and a limit parameter. If no city or coordinates are provided, it defaults to Riyadh with pickup tomorrow and drop-off the day after. Each car object in the response includes daily pricing, the rental office's details, whether the car supports subscription plans, and installment data. The total field in the response reflects how many cars matched the query.
Special Offers and Subscriptions
get_special_offers returns cars where discount_price is lower than the regular price, using the same car object shape as search_cars. No inputs are required. search_cars_subscription filters for cars available on monthly plans and returns subscription pricing at 1, 3, 6, 9, and 12-month tiers alongside the standard car and office fields. It accepts an optional city_name parameter and defaults to Riyadh.
Response Shape Notes
All car-returning endpoints share a consistent response shape: a cars array and an integer total. The slug values returned by list_cities can be used to populate city_name in search_cars and search_cars_subscription. Coordinates from list_cities can substitute for city name in search_cars via lat and lng.
The Telgani API is a managed, monitored endpoint for telgani.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when telgani.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official telgani.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Aggregate daily rental prices across Riyadh, Jeddah, and Dammam for fare-comparison tools
- Build a subscription-plan comparison app using 1, 3, 6, 9, and 12-month pricing from search_cars_subscription
- Populate a city selector UI with GPS coordinates and slugs from list_cities
- Surface discounted rental deals using get_special_offers with discount_price vs. regular price comparison
- Filter rental inventory by brand or vehicle type using IDs from list_car_brands and list_car_types
- Track office-level availability and installment options across multiple pickup locations
- Monitor special offer availability over time for price-alert or deal-notification services
| 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 | 100 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.