{"uid":"cap_Tj9Y2Pl8uuYZZDyHTVJN0","slug":"traffic-index-operating-window-planner-58a7635b","name":"Traffic Index Operating Window Planner","description":"Pay-per-call data & tool APIs","url":"https://api.timzinin.com/api/traffic-index-operating-window-planner","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"windows":{"type":"array","items":{"type":"object","required":["windowId","scheduledAt","flexHours","maxTrafficIndex","costPerIndexPointUsd"],"properties":{"windowId":{"type":"string","pattern":"^[A-Za-z0-9_-]+$","maxLength":64,"minLength":1},"flexHours":{"type":"integer","maximum":6,"minimum":0},"scheduledAt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:00\\+03:00$"},"maxTrafficIndex":{"type":"integer","maximum":99,"minimum":1},"costPerIndexPointUsd":{"type":"number","maximum":10000,"minimum":0}},"additionalProperties":false},"maxItems":50,"minItems":1},"requestId":{"type":"string","pattern":"^[A-Za-z0-9_-]+$","maxLength":64,"minLength":8},"maxTotalChargeUsd":{"type":"number","maximum":100,"minimum":0.025}}},"responseSchema":{"type":"json","example":{"meta":{"run_ms":1200,"settled":true,"item_count":1},"results":[{"action":"shift_to_lower_traffic_hour","source":{"url":"https://api.ibb.gov.tr/tkmservices/api/TrafficData/v1/TrafficIndexHistory/28/H","bytes":40886,"route":"direct","sha256":"9186eb3d790cd04d322578389bcb2f97bf06ba0c616beb088bb061793a9e55b4","datasetUrl":"https://data.ibb.gov.tr/dataset/trafik-indeks-degeri-web-servisi","licenseUrl":"https://data.ibb.gov.tr/license","recordCount":673,"retrievedAt":"2026-08-14T06:44:56.077Z","declaredBytes":null,"latestTimestamp":"2026-08-14T09:00:00","oldestTimestamp":"2026-07-17T09:00:00"},"country":"TR","product":"traffic-index-operating-window-planner","baseline":false,"billable":true,"decision":"operating-window-plan","stableId":"IBB-TRAFFIC-WINDOW:a8686b41e776598a10f0331c","windowId":"dispatch_am","flexHours":2,"attribution":"Source: Istanbul Metropolitan Municipality (İBB) Open Data Portal, Istanbul Traffic Index Web Service; licensed under the İBB Open Data Licence / CC BY 4.0-compatible attribution terms.","scheduledAt":"2026-08-18T08:30:00+03:00","sourceStats":{"recordCount":673,"sourceTimezone":"Europe/Istanbul","latestTimestamp":"2026-08-14T09:00:00","oldestTimestamp":"2026-07-17T09:00:00","baselinePercentile":75,"distinctWeekdayHourSlots":168},"plannedMinute":30,"schemaVersion":"1.0","criteriaSha256":"3ad79df5103c600f3bf90c870d0a710f26445926e516363affb2bddb187d5b87","maxTrafficIndex":45,"plannedBaseline":{"hour":8,"weekday":2,"p75Index":49,"medianIndex":48,"offsetHours":0,"sampleCount":4,"maximumIndex":50,"minimumIndex":46},"exceedsThreshold":true,"plannedLocalHour":8,"methodologyCaveat":"The result is an explainable historical weekday/hour benchmark, not a traffic forecast, route-specific travel time, navigation instruction, or SLA guarantee. Verify current conditions before dispatch.","plannedLocalWeekday":2,"recommendedBaseline":{"hour":6,"weekday":2,"p75Index":12,"medianIndex":11,"offsetHours":-2,"sampleCount":4,"maximumIndex":13,"minimumIndex":9},"recommendedLocalHour":6,"expectedIndexReduction":37,"recommendedOffsetHours":-2,"recommendedLocalWeekday":2,"estimatedAvoidableCostUsd":462.5}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1C0jF7k-U_NjdvkF3cjMY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes Istanbul historical traffic index data to recommend optimal low-traffic dispatch or operating time windows for a given weekday and hour","exampleAgentPrompt":"Based on Istanbul historical traffic index data, find me the best low-traffic operating window for a Tuesday morning dispatch around 8:30am — I can be flexible by up to 2 hours if it means hitting significantly lighter traffic.","exampleUseCases":[{"title":"Morning logistics dispatch optimization","prompt":"I need to schedule a morning delivery fleet dispatch in Istanbul this Tuesday. My target is around 8:30am but I have 2 hours of flexibility — can you find the historical traffic window with the lowest traffic index for Tuesday mornings so I don't get stuck in peak congestion?"},{"title":"Construction crew shift planning","prompt":"We're planning construction work that needs vehicles to arrive at a site in Istanbul on Wednesday mornings. Can you check historical Istanbul traffic index data and tell me what hour has the lightest traffic on Wednesday so we can avoid delays getting crews there?"},{"title":"Event shuttle schedule adjustment","prompt":"I'm coordinating shuttles for an event in Istanbul next Thursday morning — originally scheduled for 8am. Can you analyze the historical traffic index for Thursday mornings and recommend the quietest 1-hour window within 2 hours of 8am to minimize travel time for guests?"}],"resultDescription":"Returns a structured operating window plan including the planned local hour and weekday, a recommended baseline hour with lower historical traffic (p75 index, median, min/max), offset hours from the requested time, traffic index statistics for both the requested and recommended slots, whether the requested time exceeds the traffic threshold, and methodology caveats clarifying that results are historical benchmarks rather than real-time forecasts.","failureModes":["Requested datetime falls outside available historical data range (oldest to latest timestamp)","Traffic data source (İBB API) unavailable or returns stale data","Invalid or missing windowId or scheduledAt parameters","Flex hours value out of acceptable range","No lower-traffic alternative found within the flex window (all slots exceed threshold)","Payment settlement failure via x402 protocol"],"whenToPreferThis":"Choose this endpoint when you need a historically-grounded, explainable traffic-light window recommendation for Istanbul specifically, and your use case involves scheduling or dispatching (logistics, fleet, construction, events) rather than real-time navigation. It is not a traffic forecast or routing engine — use it when you want a defensible weekday/hour benchmark to anchor your scheduling decisions, with flex-hour alternatives pre-computed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:53:49.730Z","isFirstParty":false}