🔑 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.

GET · JSON11 endpoints60 requests a minute per keyCORS *openapi.json ↗

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.

    ParameterInDescription
    lat requiredqueryLatitude of the point.
    lng requiredqueryLongitude of the point.
    radius queryMetres around the point (default 1500, at most 5000).
    limit queryAt 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.

    ParameterInDescription
    id requiredpath
    GET/api/v1/deals— Deals and cashback near a point (Takhfifan)

    Iran only.

    ParameterInDescription
    lat requiredqueryLatitude of the point.
    lng requiredqueryLongitude of the point.
    radius queryMetres around the point (default 5000, at most 15000).
    limit queryAt 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).

    ParameterInDescription
    lat requiredqueryLatitude of the point.
    lng requiredqueryLongitude of the point.
    radius queryMetres around the point (default 20000, at most 60000).
    limit queryAt 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.

    ParameterInDescription
    id requiredpath
    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.

    ParameterInDescription
    lat requiredqueryLatitude of the point.
    lng requiredqueryLongitude of the point.
    limit queryAt 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.

    ParameterInDescription
    lat requiredqueryLatitude of the point.
    lng requiredqueryLongitude of the point.
    q requiredqueryWords to look for (2–60 characters).
    min queryLowest price.
    max queryHighest price.
    sort queryOrder.
    limit queryAt 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).

    ParameterInDescription
    lat requiredqueryLatitude of the point.
    lng requiredqueryLongitude of the point.
    radius queryMetres around the point (default 700, at most 2000).
    limit queryAt 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.

    ParameterInDescription
    id requiredpath
    lat requiredqueryLatitude of the point.
    lng requiredqueryLongitude 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.

    ParameterInDescription
    lat requiredqueryLatitude of the point.
    lng requiredqueryLongitude of the point.
    radius queryMetres around the point (default 2500, at most 5000).
    limit queryAt 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).

    ParameterInDescription
    city requiredpath

    Sources and licences

    Every answer lists its sources in meta.sources. Please keep the attribution when you show the data.

    • OpenStreetMap contributors · worldwide
      ODbL 1.0 — attribute “© OpenStreetMap contributors”.
    • Snappfood · IR
      Data 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 · TR
      Data 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 · IR
      Data 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 · IR
      Data 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 · IR
      Data 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 · IR
      Data 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 · IR
      Data 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”.
    Developers · StreetQuest