Data API

Every woke score, ready for your own lists

Query all 5,777 movies and TV shows we have reviewed by genre, year, score or IMDb ID, and build the lists you actually want. $7 a month, and every subscription also helps fund new reviews.

Read the docs

Secure checkout by Stripe · Cancel any time · Personal use

GET /api/v1/titles?genre=comedy&year_min=2020
    &sort=woke_score&per_page=10

{
  "data": [
    {
      "name": "…",
      "year": 2023,
      "woke_score": 4,
      "verdict": "Not woke",
      "imdb_id": "tt…",
      "score_factors": [ … ]
    },
    …
  ]
}

5,777

movies and TV shows reviewed

100

titles per request

1,000

requests a day

Live

new reviews appear within minutes

What you can build

Lists nobody else will make

The ten least woke comedies since 2020. Sci-fi that scores under 20. Every family film from last year, ranked.

?genre=comedy&year_min=2020&sort=woke_score&per_page=10

Check your watchlist

Export your IMDb watchlist and look every title up by its IMDb ID, then sort out what to watch first.

?imdb_id=tt1745960

Keep your own copy current

Download the whole catalogue once, then fetch only the reviews that changed since your last sync.

?updated_since=2026-09-01&sort=-review_updated

API access

$7 / month

Every published score, verdict and score breakdown
Filter by genre, year, score, type, IMDb or TMDB ID
1,000 requests a day, up to 100 titles per request
Up to 3 API keys, one for each project
Also supports the site: every subscription helps fund new reviews

Renews monthly. Cancel any time from your profile.

How it works

1SubscribeCreate a free account if you do not have one, then check out securely with Stripe.
2Create an API keyRight on your profile. Name it after what you are building.
3Make your first requestCopy the quick start below. You will have results in under a minute.

Already subscribed? Your keys are on your profile.

Questions

Do I need to be a programmer?

A little. The API returns JSON, so you need a short script or a tool that can call an API with a header. The quick start below is a single command, and an AI assistant can write the rest for you from these docs.

What counts as personal use?

Your own lists, spreadsheets and tools, and sharing something you made with a credit and a link back. Reselling the data, republishing it in bulk, commercial products and training AI models are not included.

How current is the data?

The API reads the live catalogue, so new reviews and score changes show up within minutes of being published.

Does paying for the API change any scores?

No. Scores are editorial judgements, and API subscribers have no say over them.

Why are IMDb and Rotten Tomatoes ratings not included?

They belong to other companies, so we cannot pass them on. Every title carries its IMDb and TMDB IDs, so you can join those ratings in yourself.

What happens if I cancel?

Your access runs to the end of the month you paid for. Your keys pause rather than disappear, and they work again if you rejoin.

Documentation

API reference

Quick start

Create a key on your profile, then send it as a bearer token. This finds the ten least woke comedies released since 2020:

curl "https://isitwokeornot.com/api/v1/titles?genre=comedy&year_min=2020&type=movie&sort=woke_score&per_page=10" \
  -H "Authorization: Bearer wor_your_key_here"

Keep your key on a server or in a private script. Do not put it in a public web page or app, where anyone could copy it.

GET /api/v1/titles

Lists published reviews, filtered and sorted. Every parameter is optional; unknown parameters are rejected so a typo never silently returns the whole catalogue.

Parameter	Description
type	`movie` or `tv`.
genre	A genre slug such as `comedy`. Comma-separate up to 5 to require all of them (`comedy,romance`). See /genres.
min_score, max_score	Woke score range, 0-100, inclusive.
year_min, year_max	Release year range, inclusive.
q	Title name contains this text (case-insensitive, 2+ characters).
imdb_id	Look up by IMDb ID, e.g. `tt1745960`.
tmdb_id	Look up by TMDB ID. Movies and TV shows can share an ID, so combine it with `type`.
updated_since	Only titles whose review changed on or after this ISO 8601 date. Use it to keep a local copy in sync.
sort	`release_date`, `woke_score`, `name` or `review_updated`; prefix with `-` for descending. Default `-release_date`.
page	Page number, starting at 1.
per_page	Results per page, 1-100. Default 50.

Example response:

{
  "data": [
    {
      "id": "cmntqj64n00a7js2ei3ah8lv0",
      "name": "Top Gun: Maverick",
      "type": "movie",
      "year": 2022,
      "release_date": "2022-05-21",
      "genres": [
        {
          "slug": "action",
          "name": "Action"
        },
        {
          "slug": "drama",
          "name": "Drama"
        }
      ],
      "age_rating": "PG-13",
      "runtime_minutes": 131,
      "reviewed_season_count": null,
      "woke_score": 15,
      "verdict": "Not woke",
      "score_factors": [
        {
          "label": "Woke representation / casting",
          "weight": 22
        },
        {
          "label": "Woke political dialogue",
          "weight": 0
        },
        {
          "label": "Identity-driven story themes",
          "weight": 0
        },
        {
          "label": "Western institutional / cultural critique",
          "weight": 0
        },
        {
          "label": "Woke character or canon changes",
          "weight": 0
        },
        {
          "label": "Anti-woke backlash and complaints",
          "weight": 10
        },
        {
          "label": "Creator track record context",
          "weight": 10
        }
      ],
      "content_tags": [],
      "imdb_id": "tt1745960",
      "tmdb_id": 361743,
      "url": "https://isitwokeornot.com/movie/top-gun-maverick",
      "review_published_at": "2026-05-13T05:25:03.099Z",
      "review_updated_at": "2026-09-19T13:11:06.873Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 50,
    "total": 1,
    "total_pages": 1
  }
}

Field	Description
woke_score	Our editorial score, 0 (not woke) to 100.
verdict	The score band: Not woke, Slightly woke, Woke, Very woke or Super woke.
score_factors	The breakdown behind the score, in the order shown on the review page.
content_tags	Badges shown on the review, such as `rainbow`.
reviewed_season_count	TV only: how many seasons the review covers.
imdb_id, tmdb_id	Identifiers for joining our scores with other data sources.
url	The full review on our site. Please link to it when you share our scores.

GET /api/v1/genres

The genre slugs you can filter by, with how many published titles each has.

{ "data": [ { "slug": "action", "name": "Action", "title_count": <number> }, ... ] }

Rate limits

Each account can make 1,000 requests a day (resetting at 00:00 UTC) and 60 a minute, shared across all of its keys. That is enough to download the whole catalogue many times a day. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset (a Unix timestamp) for the daily allowance.

Errors

Errors return JSON shaped as { "error": { "code": "...", "message": "..." } }.

Status	Code	Meaning
400	invalid_request	A parameter is unknown or has an invalid value. The message says which.
401	unauthorized	The key is missing, wrong, or revoked.
403	subscription_inactive	The key is valid but the subscription has lapsed. Renewing turns it back on.
429	rate_limited	Over the minute or daily limit. Wait for the number of seconds in `Retry-After`.
500	server_error	Something failed on our side. Retry after a short pause.

What is not included

The API covers what we create: scores, verdicts, score breakdowns and tags, plus the basic facts and IDs needed to use them. IMDb, Rotten Tomatoes and Metacritic ratings, box office figures, posters, synopses and streaming availability belong to other companies, so we cannot pass them on. Use imdb_id or tmdb_id to join our scores with those sources yourself.

Fair use

API access is for personal, non-commercial use. Please credit Is It Woke or Not? with a link when you share something built on our scores, and do not republish the data in bulk or use it to train AI models. The full rules are in our terms. For commercial licensing, get in touch.

Loading…