🔑 StreetQuest data API
A read-only data API for other apps: the stores, deals, cinemas, ads and products StreetQuest knows. It answers from our cache, with each source credited.
Your API keys
How to call it
curl -H "Authorization: Bearer sq_live_…" \ "https://streetquest.remixt.app/api/v1/stores?lat=35.70&lng=51.34&radius=1500"
Each key may make 60 requests a minute; over that you get a 429 with Retry-After. Only GET is allowed, from any origin.
Endpoints
GET/api/v1/stores— Stores near a point
Delivery restaurants and shops (Snappfood in Iran, Yemeksepeti in Turkey) and Torob's walk-in stores, nearest first.
| Parameter | In | Description |
|---|---|---|
lat required | query | Latitude of the point. |
lng required | query | Longitude of the point. |
radius | query | Metres around the point (default 1500, at most 5000). |
limit | query | At most this many rows (default 50, at most 100). |
GET/api/v1/stores/{id}— One store: menu, hours, review summary
`id` is a store id from /stores (a Snappfood or Yemeksepeti vendor code). Walk-in Torob stores (`torob-<n>`) answer with their listing.
| Parameter | In | Description |
|---|---|---|
id required | path |
GET/api/v1/deals— Deals and cashback near a point (Takhfifan)
Iran only.
| Parameter | In | Description |
|---|---|---|
lat required | query | Latitude of the point. |
lng required | query | Longitude of the point. |
radius | query | Metres around the point (default 5000, at most 15000). |
limit | query | At most this many rows (default 50, at most 100). |
GET/api/v1/cinemas— Cinemas near a point
Iran: Cinematicket's (with sessions). Turkey: the open map's (`site` is the cinema's own page; no sessions).
| Parameter | In | Description |
|---|---|---|
lat required | query | Latitude of the point. |
lng required | query | Longitude of the point. |
radius | query | Metres around the point (default 20000, at most 60000). |
limit | query | At most this many rows (default 50, at most 100). |
GET/api/v1/cinemas/{id}/sessions— Films and sessions at a cinema, today and tomorrow
Prices in toman.
| Parameter | In | Description |
|---|---|---|
id required | path |
GET/api/v1/ads— Latest Divar ads in the neighbourhoods around a point
Iran only. Titles, price text, photo and link; never sellers or phone numbers.
| Parameter | In | Description |
|---|---|---|
lat required | query | Latitude of the point. |
lng required | query | Longitude of the point. |
limit | query | At most this many rows (default 50, at most 100). |
GET/api/v1/products— Product search
Dishes on cached menus nearby, deals, Torob and Basalam products. Only cached menus are read.
| Parameter | In | Description |
|---|---|---|
lat required | query | Latitude of the point. |
lng required | query | Longitude of the point. |
q required | query | Words to look for (2–60 characters). |
min | query | Lowest price. |
max | query | Highest price. |
sort | query | Order. |
limit | query | At most this many rows (default 50, at most 100). |
GET/api/v1/transit/stops— Bus stops near a point
Tehran and Istanbul: each stop with the lines calling there (OpenStreetMap).
| Parameter | In | Description |
|---|---|---|
lat required | query | Latitude of the point. |
lng required | query | Longitude of the point. |
radius | query | Metres around the point (default 700, at most 2000). |
limit | query | At most this many rows (default 50, at most 100). |
GET/api/v1/transit/stops/{id}— When each line's next bus comes to a stop
Live in Istanbul when IETT answers (minutes estimated from the nearest bus of the line), else each line's usual frequency. Needs the stop's lat/lng.
| Parameter | In | Description |
|---|---|---|
id required | path | |
lat required | query | Latitude of the point. |
lng required | query | Longitude of the point. |
GET/api/v1/transit/buses— Istanbul's buses live near a point
IETT's positions (refreshed every 20 s). Empty outside Istanbul or when the feed isn't reachable.
| Parameter | In | Description |
|---|---|---|
lat required | query | Latitude of the point. |
lng required | query | Longitude of the point. |
radius | query | Metres around the point (default 2500, at most 5000). |
limit | query | At most this many rows (default 50, at most 100). |
GET/api/v1/metro/{city}— A city's metro: lines in order, stations, usual frequency and hours
`city`: tehran or istanbul. From OpenStreetMap; times are estimates (`mapped`: from the map, else the city's usual).
| Parameter | In | Description |
|---|---|---|
city required | path |
Sources and licences
Every answer lists its sources in meta.sources. Please keep the attribution when you show the data.
- OpenStreetMap contributors · worldwideODbL 1.0 — attribute “© OpenStreetMap contributors”.
- Snappfood · IRData belongs to the site named here. Shown for information with attribution and a link back; do not bulk-copy or resell it. Prices are as that site listed them at the time of fetching.
- Yemeksepeti · TRData belongs to the site named here. Shown for information with attribution and a link back; do not bulk-copy or resell it. Prices are as that site listed them at the time of fetching.
- Torob · IRData belongs to the site named here. Shown for information with attribution and a link back; do not bulk-copy or resell it. Prices are as that site listed them at the time of fetching.
- Takhfifan · IRData belongs to the site named here. Shown for information with attribution and a link back; do not bulk-copy or resell it. Prices are as that site listed them at the time of fetching.
- Divar · IRData belongs to the site named here. Shown for information with attribution and a link back; do not bulk-copy or resell it. Prices are as that site listed them at the time of fetching. Sellers' names and phone numbers are never included.
- Cinematicket · IRData belongs to the site named here. Shown for information with attribution and a link back; do not bulk-copy or resell it. Prices are as that site listed them at the time of fetching.
- Basalam · IRData belongs to the site named here. Shown for information with attribution and a link back; do not bulk-copy or resell it. Prices are as that site listed them at the time of fetching.
- IETT (İBB Open Data) · TRİBB Open Data Licence — attribute “İstanbul Büyükşehir Belediyesi”.