Crosby News Traffic API

openapi: 3.2.0
info:
  title: crosbynews.com Traffic API
  version: 1.7.0
  description: 'Crosby, Texas community data: current conditions, hourly and 7-day forecast, active alerts, the EPA UV index, and a measured air-quality index (EPA/AirNow monitors, with an Open-Meteo modeled fallback) from the U.S. National Weather Service, EPA/AirNow, and Open-Meteo; river/bayou flood levels; the Atlantic tropical outlook; the Houston Health Department''s measured daily pollen and mold count; the Harris County burn-ban status from the Texas A&M Forest Service; road incidents and lane closures from Houston TranStar; recent local news headlines; and the Crosby ISD school calendar. Public, no authentication.'
  contact:
    url: https://crosbynews.com/
  license:
    name: Public domain (NWS source data)
    url: https://www.weather.gov/disclaimer
servers:
- url: https://crosbynews.com
security: []
tags:
- name: Traffic
paths:
  /api/traffic:
    get:
      operationId: getTraffic
      summary: Traffic incidents and lane closures on Crosby, TX area roads
      parameters:
      - $ref: '#/components/parameters/IfNoneMatch'
      responses:
        '200':
          description: Incidents and scheduled lane closures on US-90, FM-2100, FM-1942, and the Crosby stretch of IH-10 East, from Houston TranStar. Empty arrays mean quiet roads; null means that feed was unreachable at the last refresh.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Traffic'
        '304':
          $ref: '#/components/responses/NotModified'
        '502':
          description: Traffic data unavailable
      tags:
      - Traffic
components:
  responses:
    NotModified:
      description: Not Modified — the caller's If-None-Match matches the current snapshot, so no body is sent. The ETag is derived from the cache's refresh stamp, so it changes exactly when the payload would.
  parameters:
    IfNoneMatch:
      name: If-None-Match
      in: header
      required: false
      description: A previously returned weak ETag. When it still matches the cached snapshot, the endpoint answers 304 with no body — the cheap way to poll.
      schema:
        type: string
  schemas:
    Traffic:
      type: object
      properties:
        area:
          type: string
        source:
          type: string
        updated:
          type:
          - string
          - 'null'
          format: date-time
        incidents:
          type:
          - array
          - 'null'
          description: Live incidents on the Crosby corridors; empty = quiet, null = feed unreachable at the last refresh.
          items:
            type: object
            properties:
              location:
                type: string
                description: TranStar location text, e.g. "US-90 Eastbound At RUNNEBURG RD".
              type:
                type: string
                description: Incident type(s), e.g. "Accident", "Stall", "High Water".
              status:
                type: string
                description: TranStar status, e.g. "Verified at 4:24 PM" (Central time).
              lanesAffected:
                type:
                - string
                - 'null'
        laneClosures:
          type:
          - array
          - 'null'
          description: Scheduled lane closures on the Crosby corridors; empty = none, null = feed unreachable at the last refresh.
          items:
            type: object
            properties:
              location:
                type: string
              schedule:
                type: string
                description: TranStar schedule text, e.g. "Closed nightly 9:00 PM to 5:00 AM through Friday, July 17".
              lanesAffected:
                type:
                - string
                - 'null'
              status:
                type:
                - string
                - 'null'
        cameras:
          type: array
          description: TranStar traffic cameras on the Crosby corridors. pageUrl links TranStar's own camera page — snapshot images are not embedded or proxied here.
          items:
            type: object
            properties:
              name:
                type: string
              roadway:
                type: string
              lat:
                type: number
              lon:
                type: number
              pageUrl:
                type: string
                format: uri
        liveMapUrl:
          type: string
          format: uri
        note:
          type: string