Creative Notes Cloud

The most-mentioned words across the notes of the creatives the current filters match, largest first — the word cloud on the creatives page.

The feed’s filters, and neither its sort nor its cursor: the cloud is over the whole matched set, not over a page of it. Clicking a word puts it in the search box, which matches name and notes together, so the cloud narrows the feed it was built from.

Cached per filter combination, because this is the one creatives read with no index behind it — a word inside a string is not indexable — and the unfiltered page is a state every reader shares. Flat parameters rather than a params model so the key can name them; the TTL is short enough that a notes edit shows up without an explicit invalidation.

curl -X GET "/api/v1/creatives/notes-cloud" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("/api/v1/creatives/notes-cloud", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "/api/v1/creatives/notes-cloud",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

{
  "success": true,
  "data": {
    "words": [
      {
        "word": "string",
        "count": 0
      }
    ]
  },
  "message": "string",
  "errors": [
    "string"
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}