{"openapi":"3.1.0","info":{"title":"eSIM Türkei Public API","version":"1.0.0","description":"Read-only REST API for eSIM provider and plan data for Turkey. No authentication required. All prices in EUR. Data updated monthly. No affiliate links are exposed — use pageUrl/buyPageUrl to direct users to e-simturkei.de.","contact":{"url":"https://www.e-simturkei.de/ueber-uns"},"license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"}},"servers":[{"url":"https://www.e-simturkei.de/api/v1","description":"Production"}],"paths":{"/providers":{"get":{"operationId":"listProviders","summary":"List all eSIM providers","description":"Returns all tested eSIM providers for Turkey with pricing, network, and feature metadata. Filter by network, tethering support, unlimited plans, or voice support.","parameters":[{"name":"network","in":"query","schema":{"type":"string","enum":["Turkcell","Türk Telekom","Vodafone Turkey","Multi-Network"]},"description":"Filter by Turkish network operator"},{"name":"tethering","in":"query","schema":{"type":"boolean"},"description":"Filter by hotspot/tethering support"},{"name":"unlimited","in":"query","schema":{"type":"boolean"},"description":"Filter by unlimited plan availability"},{"name":"voice","in":"query","schema":{"type":"boolean"},"description":"Filter by voice/call support"}],"responses":{"200":{"description":"Array of provider objects","content":{"application/json":{"schema":{"type":"object","properties":{"providers":{"type":"array","items":{"$ref":"#/components/schemas/Provider"}},"total":{"type":"integer"},"updatedAt":{"type":"string","format":"date"},"source":{"type":"string","format":"uri"}}}}}}}}},"/providers/{slug}":{"get":{"operationId":"getProvider","summary":"Get a single provider by slug","description":"Returns full provider profile including pros/cons and all available Turkey plans.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","enum":["airalo","saily","holafly","nomad","yesim","breeze","gigsky","drimsim","ubigi","jetpac","lycamobile","roamic"]}}],"responses":{"200":{"description":"Provider with plans","content":{"application/json":{"schema":{"type":"object","properties":{"provider":{"$ref":"#/components/schemas/ProviderDetail"},"plans":{"type":"array","items":{"$ref":"#/components/schemas/Plan"}},"planCount":{"type":"integer"},"updatedAt":{"type":"string","format":"date"}}}}}},"404":{"description":"Provider not found"}}}},"/plans":{"get":{"operationId":"listPlans","summary":"List and filter eSIM plans","description":"Returns paginated list of all Turkey eSIM plans. Supports filtering by provider, price, data volume, duration, network, and plan type. Sorted by price by default.","parameters":[{"name":"provider","in":"query","schema":{"type":"string"},"description":"Provider slug (e.g. airalo, saily, holafly)"},{"name":"maxPriceEur","in":"query","schema":{"type":"number"},"description":"Maximum price in EUR"},{"name":"minDataGb","in":"query","schema":{"type":"number"},"description":"Minimum data in GB"},{"name":"durationDays","in":"query","schema":{"type":"integer"},"description":"Exact duration in days"},{"name":"network","in":"query","schema":{"type":"string"},"description":"Network operator"},{"name":"planType","in":"query","schema":{"type":"string","enum":["data","unlimited"]},"description":"Plan type"},{"name":"sort","in":"query","schema":{"type":"string","enum":["price","value","duration"],"default":"price"},"description":"Sort order"},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":50}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Paginated plan list","content":{"application/json":{"schema":{"type":"object","properties":{"plans":{"type":"array","items":{"$ref":"#/components/schemas/Plan"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"updatedAt":{"type":"string","format":"date"}}}}}}}}},"/search":{"get":{"operationId":"search","summary":"Search providers and plans","description":"Full-text search across provider names, networks, bestFor tags, and plan attributes. Returns matched providers and plans.","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2},"description":"Search query (e.g. \"turkcell\", \"unlimited\", \"airalo\", \"kappadokien\")"}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"results":{"type":"object","properties":{"providers":{"type":"array"},"plans":{"type":"array"}}},"totalProviders":{"type":"integer"},"totalPlans":{"type":"integer"}}}}}},"400":{"description":"Missing or too-short query"}}}}},"components":{"schemas":{"Provider":{"type":"object","properties":{"slug":{"type":"string","example":"airalo"},"name":{"type":"string","example":"Airalo"},"network":{"type":"string","example":"Turkcell"},"rating":{"type":"string","example":"4.7"},"reviewCount":{"type":"integer","example":15000},"minPriceEur":{"type":"number","example":4},"supportsTethering":{"type":"boolean"},"supportsUnlimited":{"type":"boolean"},"supportsVoice":{"type":"boolean"},"bestFor":{"type":"array","items":{"type":"string"}},"coverageCities":{"type":"array","items":{"type":"string"}},"pageUrl":{"type":"string","format":"uri"}}},"ProviderDetail":{"allOf":[{"$ref":"#/components/schemas/Provider"},{"type":"object","properties":{"description":{"type":"string"},"pros":{"type":"array","items":{"type":"string"}},"cons":{"type":"array","items":{"type":"string"}},"competitors":{"type":"array","items":{"type":"string"}},"trustpilotUrl":{"type":"string","format":"uri"}}}]},"Plan":{"type":"object","properties":{"id":{"type":"string","example":"airalo-5gb-7d"},"provider":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"rating":{"type":"string"},"pageUrl":{"type":"string","format":"uri"}}},"dataAmount":{"type":"string","example":"5 GB"},"dataMb":{"type":"integer","nullable":true,"example":5120},"durationDays":{"type":"integer","example":7},"priceEur":{"type":"number","example":9},"pricePerGb":{"type":"number","nullable":true,"example":1.8},"network":{"type":"string","example":"Turkcell"},"speed":{"type":"string","example":"4G/LTE"},"planType":{"type":"string","enum":["data","unlimited"]},"buyPageUrl":{"type":"string","format":"uri"}}}}}}