Discover/metro.istanbul API
live

metro.istanbul APImetro.istanbul

Access Istanbul Metro lines, stations, real-time service status, ticket prices, and network maps via 6 structured endpoints.

Endpoints
6
Updated
17d ago
Try it

No input parameters required.

api.parse.bot/scraper/c9026794-8ccd-456e-a6fb-d85c5e313a38/<endpoint>
Ready to send
Fill in the parameters and hit sign in to send to see live response data here.
Use it in your codegrab a free API key at signup
curl -X GET 'https://api.parse.bot/scraper/c9026794-8ccd-456e-a6fb-d85c5e313a38/get_all_lines' \
  -H 'X-API-Key: $PARSE_API_KEY'
All endpoints · 6 totalclick to expand

Get all transit lines operated by Metro Istanbul. Returns line codes, display names, IDs, and color codes.

Input

No input parameters required.

Response
{
  "type": "object",
  "fields": {
    "data": "array of line objects with METROISTHATID, HATADI, HATTANIM, EKTANIM, RENKR, RENKG, RENKB",
    "status": "string, always 'success'"
  },
  "sample": {
    "data": [
      {
        "RENKB": "88",
        "RENKG": "115",
        "RENKR": "124",
        "HATADI": "F1",
        "EKTANIM": "Taksim-Kabataş Füniküler Hattı",
        "HATTANIM": "F1 ISLETME",
        "METROISTHATID": 4
      }
    ],
    "status": "success"
  }
}

About the metro.istanbul API

The Metro Istanbul API exposes 6 endpoints covering every aspect of Istanbul's metro and tram network — from full line listings with RGB color codes via get_all_lines, to real-time service disruptions and faulty elevator counts via get_service_status. Response fields include station ordering, SAP codes, fare categories by card type, transfer connections, and direct links to network map images for all active and under-construction lines.

Lines and Stations

get_all_lines returns every transit line operated by Metro Istanbul, including the internal identifier (METROISTHATID), the line display name (HATADI, HATTANIM), supplementary annotation (EKTANIM), and the RGB color values (RENKR, RENKG, RENKB) used in official maps. get_all_stations complements this with a full station roster across all lines, including station_id, name, display_name, line_id, line_name, ordering position, and sap_code for each station.

Line Detail and Transfers

get_line_detail accepts a line_code parameter (e.g., M2, T1, F4, TF2) and returns the full station sequence for that line, key operating metrics under details, and a transfers array listing interchange connections. Valid line codes span metro (M1A–M9), tram (T1, T3–T5), funicular (F1, F4), and cable car (TF1, TF2) services.

Service Status and Fares

get_service_status returns the seferDurumlari array — each element describes an active service disruption; an empty array indicates normal operation. The same response includes string-typed counts of faulty elevators (arizaliAsansor) and escalators (arizaliYuruyenMerdiven), making it useful for accessibility monitoring. get_ticket_prices returns fare objects keyed by category, type, and price, reflecting the current tariff for each card class (full fare, student, senior, etc.).

Network Maps

get_network_map returns an array of map objects, each with a title and a url pointing to official network map images — covering metro, tramway, and construction-phase maps. No parameters are required for any of the listing or status endpoints.

Common use cases
  • Build a transit app that renders line colors from RENKR/RENKG/RENKB values returned by get_all_lines
  • Display live service disruption banners by polling get_service_status and checking the seferDurumlari array
  • Show out-of-service elevator counts per station for accessibility-focused routing apps
  • Populate a station autocomplete using display_name and line_name fields from get_all_stations
  • Render transfer connection graphs by parsing the transfers array from get_line_detail
  • Show current fares by card category from get_ticket_prices for trip cost estimation
  • Embed official network map images from get_network_map into a route planning interface
Pricing & limitsSee full pricing →
TierPriceCredits/monthRate limit
Free$0/mo1005 req/min
Hobby$30/mo1,00020 req/min
Developer$100/mo5,000250 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.

Frequently asked questions
Does Metro Istanbul have an official public developer API?+
Metro Istanbul does not publish a documented public developer API. This Parse API provides structured access to the same data available on metro.istanbul.
What does get_service_status actually return when service is normal?+
When there are no active disruptions, the seferDurumlari array is empty. The response still includes string counts for faulty elevators (arizaliAsansor) and escalators (arizaliYuruyenMerdiven), which may be non-zero even during normal service.
Does get_line_detail cover all line types, or only metro lines?+
It covers metro (M1A through M9), tram (T1, T3, T4, T5), funicular (F1, F4), and cable car (TF1, TF2) lines. All valid line_code values are documented in the parameter description.
Does the API return real-time vehicle positions or arrival predictions?+
Not currently. The API covers service disruption status, faulty equipment counts, line details, station lists, fares, and network maps. Real-time vehicle tracking or next-arrival predictions are not included. You can fork this API on Parse and revise it to add an endpoint targeting that data if it becomes available.
Are historical service disruption records available through get_service_status?+
Not currently. get_service_status reflects the current state only — active disruptions and live equipment fault counts. Historical disruption logs are not exposed. You can fork the API on Parse and revise it to add a logging or historical endpoint.
Page content last updated . Spec covers 6 endpoints from metro.istanbul.
Related APIs in Maps GeoSee all →
citymapper.com API
Get real-time transit information including live stop arrivals, service status, and line details across major cities worldwide. Search for nearby transit options and stay informed with service alerts to plan your commute efficiently.
mbta.com API
Track real-time subway, bus, and commuter rail departures across Greater Boston, check schedules and service alerts, and find detailed information about routes and stops. Plan your commute with up-to-the-minute MBTA transit data and never miss your connection.
ratp.fr API
Monitor real-time traffic conditions and service disruptions across Paris's RATP and RER networks to plan your commute efficiently. Get instant updates on line statuses, delays, and service alerts for all metro and regional rail lines.
turkishairlines.com API
Search Turkish Airlines flights and airport locations, then check real-time flight status to stay updated on your travel plans. Browse available flights to find the best options for your journey, though availability searches may occasionally experience interruptions due to site protection measures.
gtt.to.it API
Access GTT (Turin) public transport data including available service basins, line routes and stop lists, full-day timetables by route and date, stop search, and real-time arrivals with accessibility details.
rfi.it API
Check real-time train schedules and station information across Italy's railway network, search for stations, and get live alerts about delays and service disruptions. Monitor train circulation status and access detailed station mappings to plan your journeys efficiently.
amtrak.com API
Search for Amtrak trains across stations, compare fares, and discover discounts to plan your rail journey with current pricing and availability. Get detailed train information, autocomplete station names, and find the cheapest routes for your travel dates.
trenitalia.com API
Search for trains across Italy, check real-time train status and delays, view station departure and arrival boards, and find available tickets all in one place. Get live traffic information and detailed train itineraries to plan your journey with complete visibility into schedules and service disruptions.
Metro Istanbul API – Lines, Stations & Fares · Parse