itsbaba-com Blindspots API

openapi: 3.2.0
info:
  title: baba News Blindspots API
  version: 1.3.0
  description: 'The Israeli press as structured JSON: stories by side, running multi-day threads, what is accelerating, coverage gaps as a first-class resource, newsroom profiles and measured behaviour, the desk register, an incremental change feed, the daily brief, search, and people. Authenticate with `Authorization: Bearer nk_live_…`. Keys carry scopes: stories, sources, brief, search, people.'
servers:
- url: https://news.itsbaba.com
  description: Production
security:
- bearer: []
tags:
- name: blindspots
  description: Coverage gaps, by camp.
paths:
  /api/v1/blindspots:
    get:
      operationId: blindspots_list
      summary: Coverage gaps, by camp
      tags:
      - blindspots
      security:
      - bearer:
        - stories
      parameters:
      - name: lang
        in: query
        description: Output language. Hebrew falls back to English per field when a row is missing.
        schema:
          type: string
          enum:
          - en
          - he
          default: en
      - name: state
        in: query
        description: Repeatable. Unknown values are 400, unlike on /v1/stories, because this resource is only about these two.
        schema:
          type: string
          enum:
          - blindspot
          - undercovered
      - name: side
        in: query
        description: 'Return only stories the named group did not run. Unknown values are 400. Since 2026-10-01 the press is read in five groups (left, centre, right, haredi, arab), with the outlets outside them as other; the old values are still accepted as the group they became: religious as right, russian and business as other. Other is never missing, so other, russian and business return no stories.'
        schema:
          type: string
          enum:
          - left
          - centre
          - right
          - haredi
          - arab
          - other
          - official
      - name: window
        in: query
        description: How many minutes back to consider a state row current, 15-10080. Values below 15 are raised to 15; above 10080 are clamped.
        schema:
          type: integer
          minimum: 15
          maximum: 10080
      - name: limit
        in: query
        description: Page size. Non-integer or negative values are 400; values above 100 are clamped to 100 and echoed as page.limit.
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 40
      - name: cursor
        in: query
        description: Opaque keyset cursor from a previous page nextCursor. Malformed values are 400.
        schema:
          type: string
      responses:
        '200':
          description: Success
          headers:
            X-RateLimit-Limit:
              schema:
                type: integer
              description: Requests allowed this minute. Omitted when no positive limit is known.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: Requests left this minute. Omitted when no positive limit is known.
            X-Request-Id:
              schema:
                type: string
              description: Opaque id for this request.
            ETag:
              schema:
                type: string
              description: Body hash. Send as If-None-Match on later GETs.
            Cache-Control:
              schema:
                type: string
              description: private, max-age=60 on keyed GETs.
          content:
            application/json:
              schema:
                type: object
              example:
                data:
                - storyId: 44
                  state: blindspot
                  label: Not in the Haredi press
                  importance: 8.4
                  heat: 5.1
                  velocity: 6
                  acceleration: 4
                  significance: 4
                  sides:
                    centre: 2
                    left: 1
                  missingSides:
                  - haredi
                  threadId: null
                  computedAt: '2026-09-04T11:55:00.000Z'
                  gaps:
                  - side: haredi
                    label: Haredi press
                  story:
                    id: 44
                    url: https://news.itsbaba.com/story/44/cabinet-approves
                    headline: Cabinet approves the deal
                    summary: Ministers voted after midnight.
                    topic: politics
                    lang: en
                    publishedAt: '2026-09-01T08:00:00.000Z'
                    latestAt: '2026-09-01T08:00:00.000Z'
                    outlets: 3
                    sides:
                      centre: 2
                      left: 1
                    missingSides:
                    - haredi
                    state: consensus
                    verdict: null
                    lean:
                      left: 1
                      center: 2
                      right: 0
                      unrated: 0
                    sources:
                    - ynet
                    - kan
                    - haaretz_he
                    thread: null
                    updatedAt: null
                nextCursor: null
                states:
                - blindspot
                - undercovered
                side: null
                windowMinutes: 1440
                lang: en
                generatedAt: '2026-09-04T12:00:00.000Z'
                limit: 40
        '304':
          description: Not modified. Same ETag and Cache-Control as 200, empty body.
          headers:
            X-RateLimit-Limit:
              schema:
                type: integer
              description: Requests allowed this minute. Omitted when no positive limit is known.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: Requests left this minute. Omitted when no positive limit is known.
            X-Request-Id:
              schema:
                type: string
              description: Opaque id for this request.
            ETag:
              schema:
                type: string
              description: Body hash. Send as If-None-Match on later GETs.
            Cache-Control:
              schema:
                type: string
              description: private, max-age=60 on keyed GETs.
        '400':
          description: Invalid cursor, state, side, window, or limit.
          headers:
            X-RateLimit-Limit:
              schema:
                type: integer
              description: Requests allowed this minute. Omitted when no positive limit is known.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: Requests left this minute. Omitted when no positive limit is known.
            X-Request-Id:
              schema:
                type: string
              description: Opaque id for this request.
          content:
            application/json:
              schema:
                type: object
                required:
                - error
                properties:
                  error:
                    type: object
                    required:
                    - code
                    - message
                    properties:
                      code:
                        type: string
                        enum:
                        - unauthorized
                        - forbidden
                        - suspended
                        - rate_limited
                        - quota_exceeded
                        - not_found
                        - bad_request
                        - internal
                        - unavailable
                      message:
                        type: string
        '401':
          description: Missing or invalid API key.
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Opaque id for this request.
          content:
            application/json:
              schema:
                type: object
                required:
                - error
                properties:
                  error:
                    type: object
                    required:
                    - code
                    - message
                    properties:
                      code:
                        type: string
                        enum:
                        - unauthorized
                        - forbidden
                        - suspended
                        - rate_limited
                        - quota_exceeded
                        - not_found
                        - bad_request
                        - internal
                        - unavailable
                      message:
                        type: string
        '403':
          description: This key cannot access this endpoint.
          headers:
            X-RateLimit-Limit:
              schema:
                type: integer
              description: Requests allowed this minute. Omitted when no positive limit is known.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: Requests left this minute. Omitted when no positive limit is known.
            X-Request-Id:
              schema:
                type: string
              description: Opaque id for this request.
          content:
            application/json:
              schema:
                type: object
                required:
                - error
                properties:
                  error:
                    type: object
                    required:
                    - code
                    - message
                    properties:
                      code:
                        type: string
                        enum:
                        - unauthorized
                        - forbidden
                        - suspended
                        - rate_limited
                        - quota_exceeded
                        - not_found
                        - bad_request
                        - internal
                        - unavailable
                      message:
                        type: string
        '429':
          description: Rate limit or monthly quota exceeded.
          headers:
            X-RateLimit-Limit:
              schema:
                type: integer
              description: Requests allowed this minute. Omitted when no positive limit is known.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: Requests left this minute. Omitted when no positive limit is known.
            X-Request-Id:
              schema:
                type: string
              description: Opaque id for this request.
          content:
            application/json:
              schema:
                type: object
                required:
                - error
                properties:
                  error:
                    type: object
                    required:
                    - code
                    - message
                    properties:
                      code:
                        type: string
                        enum:
                        - unauthorized
                        - forbidden
                        - suspended
                        - rate_limited
                        - quota_exceeded
                        - not_found
                        - bad_request
                        - internal
                        - unavailable
                      message:
                        type: string
        '503':
          description: The News API is temporarily unavailable.
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Opaque id for this request.
          content:
            application/json:
              schema:
                type: object
                required:
                - error
                properties:
                  error:
                    type: object
                    required:
                    - code
                    - message
                    properties:
                      code:
                        type: string
                        enum:
                        - unauthorized
                        - forbidden
                        - suspended
                        - rate_limited
                        - quota_exceeded
                        - not_found
                        - bad_request
                        - internal
                        - unavailable
                      message:
                        type: string
components:
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: API key
      description: 'News API key. Live keys are `nk_live_` plus 32 base62 characters; test keys use `nk_test_`. Scopes: stories, sources, brief, search, people.'