generated: '2026-08-13'
method: searched
source: https://developer.ispot.tv/documentation/api/rate-limits
also:
- https://developer.ispot.tv/documentation/api/best_practices/data-availability
- https://developer.ispot.tv/sites/default/files/iSpot_API_Integration_Guide_2023-compressed.pdf
api: iSpot REST API v4
scope: per-endpoint (applied per API client)
exhaustion_status: 429
limit_count: 19
note: >-
  iSpot publishes a per-endpoint rate-limit table on its public developer site.
  Two pages carry the table and they DISAGREE on three endpoints — the dedicated
  /documentation/api/rate-limits page is treated as current and the older
  data-availability copy (last updated 7/24/2023) is recorded as `variant` so a
  consumer sees the discrepancy rather than one number presented as certain.
  iSpot states limits may change without notice.
response_headers:
  documented: true
  names_published: false
  described:
  - maximum number of requests permitted per minute
  - number of requests remaining in the current rate limit window
  - seconds (UTC) until the current rate limit window resets
  note: >-
    iSpot's Integration Guide describes three rate-limit response headers but
    never names them, and they are not observable on an unauthenticated request
    (which is rejected at 401 before the limiter reports). An agent cannot bind
    to the runtime signal without credentials — this is the single biggest
    agent-readiness gap on this API.
  retry_after: unknown
limits:
- endpoint: /v4/access
  limit: 100
  window_seconds: 900
- endpoint: /v4/account
  limit: 100
  window_seconds: 900
- endpoint: /v4/airings
  limit: 1000
  window_seconds: 60
  variant:
    limit: 50
    window_seconds: 60
    source: https://developer.ispot.tv/documentation/api/best_practices/data-availability
- endpoint: /v4/brands
  limit: 50
  window_seconds: 60
- endpoint: /v4/celebrities
  limit: 50
  window_seconds: 60
- endpoint: /v4/events
  limit: 50
  window_seconds: 60
- endpoint: /v4/industries
  limit: 50
  window_seconds: 300
- endpoint: /v4/metrics
  limit: 10
  window_seconds: 10
- endpoint: /v4/metrics/tv
  limit: 25
  window_seconds: 10
- endpoint: /v4/metrics/audience/airings
  limit: 25
  window_seconds: 10
- endpoint: /v4/metrics/tv/airings
  limit: 50
  window_seconds: 60
  source: https://developer.ispot.tv/documentation/api/best_practices/data-availability
  note: >-
    Present on the data-availability copy of the table only; absent from the
    current rate-limits page.
- endpoint: /v4/metrics/impressions/ott
  limit: 50
  window_seconds: 60
  source: https://developer.ispot.tv/documentation/api/best_practices/data-availability
  note: >-
    Raised to 50/60s in release v4.28.2 (2023-04-04). Absent from the current
    rate-limits page.
- endpoint: /v4/movies
  limit: 50
  window_seconds: 60
- endpoint: /v4/networks
  limit: 50
  window_seconds: 60
- endpoint: /v4/notifications
  limit: 100
  window_seconds: 60
- endpoint: /v4/product-categories
  limit: 50
  window_seconds: 60
- endpoint: /v4/products
  limit: 50
  window_seconds: 60
- endpoint: /v4/shows
  limit: 100
  window_seconds: 60
  variant:
    limit: 50
    window_seconds: 60
    source: https://developer.ispot.tv/documentation/api/best_practices/data-availability
- endpoint: /v4/spots
  limit: 150
  window_seconds: 60
  variant:
    limit: 50
    window_seconds: 60
    source: https://developer.ispot.tv/documentation/api/best_practices/data-availability
- endpoint: /v4/users
  limit: 50
  window_seconds: 60
- endpoint: /v4/planning
  limit: 50
  window_seconds: 60
payload_limits:
  page_size_default: 100
  page_size_max: 1000
  page_size_max_airings: 10000
  source: https://developer.ispot.tv/sites/default/files/iSpot_API_Integration_Guide_2023-compressed.pdf
changelog_signals:
- version: v4.28.11
  date: '2023-05-11'
  detail: Rate limits for the metric, spots and show endpoints were increased.
- version: v4.28.2
  date: '2023-04-04'
  detail: metrics/impressions/ott raised to 50 requests per 60 seconds.
  source: https://developer.ispot.tv/releases/api/v4/notes
x-evidence:
- url: https://developer.ispot.tv/documentation/api/rate-limits
  http_status: 200
  fetched: '2026-08-13'
- url: https://developer.ispot.tv/documentation/api/best_practices/data-availability
  http_status: 200
  fetched: '2026-08-13'