# Preview a focus on a tracker

> For the complete documentation index, see [llms.txt](https://www.shortsintel.com/llms.txt). Every docs page is also available as markdown: add .md to its URL. To connect, read [agents.md](https://www.shortsintel.com/agents.md).

POST `/v1/trackers/{id}/focus/preview`

Judges a proposed Focus on the Tracker's latest Sample without saving it: every Video with its verdict and reason, and how many would be hidden.

- Setting it later: its verdicts are kept under that Focus, so setting it afterwards with `PUT /v1/trackers/{id}/focus` costs nothing more.
- Unsupported kinds: 422 `focus_unsupported_kind`, which lists the kinds that can.

## Price

As setting the Focus: +3 credits per Video the model judges, +1 credit per Video `must_mention` rules out, nothing for a Video already judged under it.

Supports `estimate=true`: the reply is the price in Credits and whether it would be `cached`, with no Run created and nothing charged.

A cached result costs the same as a fresh one; `cached` says which you got.

## Parameters

| Name | In | Type | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `id` | path | `string` | Required | — | Tracker id. |
| `Idempotency-Key` | header | `string` | Optional | — | 1-255 printable ASCII characters. The same key and payload returns the original Run (202 while running); a different payload or operation is a 409 `idempotency_conflict`. |
| `estimate` | query | `boolean` | Optional | — | Return `{ estimate_credits, cached, videos, to_judge }` and judge nothing. |
| `max_credits` | query | `integer` min 0 | Optional | — | Most Credits the call may cost. A higher quote is a 402 `max_credits_exceeded`, no Run. Where `x-price.max_credits` is null, the Run stops at it and settles `partial`. |

## Request body

`application/json`

object

- `focus` object required The Focus to judge, not saved.
  - `text` string required Which Videos are relevant to you, in plain language, exclusions included, e.g. `Apple Inc. and its products (iPhone, Mac, AirPods, iOS). Not the fruit, recipes or orchards.` 1 to 1000 characters.
  - `must_mention` array of string Up to 20 terms of at most 60 characters. A Video that has captions or an analysis transcript, and whose caption, hashtags, captions and transcript name none of them (any case, whole term), is off focus without a model call; one with neither goes to the model, so a term said aloud still counts; one naming any is still judged against `text`.
- `estimate` boolean `true` returns `{ estimate_credits, cached }`, creates no Run and charges nothing.

## Responses

### 200 OK

`{ run, focus, sample }`; `sample` is null when the Tracker has no Sample yet. With `estimate=true`, the quote instead.

any of 2 shapes

- Option 1 object The envelope every charged operation answers with: `{ run }` while the Run is running (plus `poll_url` on the 202), joined by `result` once it completes or `error` once it fails.
  - `run` object required The Run judging the latest Sample, charged per judgment.
    - `id` string required
    - `kind` string required What was run, e.g. `video_lookup`.
    - `status` string required one of `running`, `completed`, `partial`, `failed` `partial` keeps the completed items and charges for them, up to what the Balance covers; `failed` charges nothing.
    - `created_at` string required RFC 3339.
    - `completed_at` string required nullable Null while the Run is still running.
    - `charge_credits` integer required What this Run actually cost, in Credits. A stored answer costs the same as a fresh one.
    - `list_price_credits` integer required The full price of the work asked for, in Credits. Equal to `charge_credits` unless the Run charged for only part of it.
    - `cached` boolean required True when a stored result answered without a fresh fetch.
    - `progress` object A running Research's `stage` and counts so far, such as `analysed` of `shortlisted`; a count is absent until known. Absent once the Run settles and on other kinds.
      - `stage` string required one of `keywords`, `searching`, `reading_creators`, `filtering`, `analysing`, `writing_digest`
      - `keywords` integer value at least 0
      - `creators` integer value at least 0
      - `creators_read` integer value at least 0
      - `searches` integer value at least 0
      - `found` integer value at least 0
      - `judged` integer value at least 0
      - `kept` integer value at least 0
      - `dropped_off_topic` integer value at least 0
      - `dropped_unsure` integer value at least 0
      - `shortlisted` integer value at least 0
      - `analysed` integer value at least 0
      - `updated_at` string required
  - `focus` object required The Focus previewed, as it would be stored.
    - `text` string required
    - `must_mention` array of string required
  - `sample` object required nullable Every Video of the latest Sample with `focus: { verdict, reason }`. Null when the Tracker has no Sample yet (always on a Creator Tracker).
    - `at` string required When the latest Sample's Snapshot was taken.
    - `stats` object required The full Sample's stats, unchanged by the Focus.
      - `sampled_videos` integer required
      - `views_total` number required
      - `views_median` number required nullable
      - `views_max` number required nullable
      - `likes_total` number required
      - `comments_total` number required
      - `engagement_rate` number required nullable
    - `videos` array of object required In-focus and unjudged Videos; with `include_off_focus=true` (and on a preview) every Video, each with `focus`.
      - `platform` string required
      - `id` string required
      - `url` string required nullable
      - `description` string required nullable Null when the read fetched no caption.
      - `posted_at` string required nullable YouTube: exact when its web player answered, else the date only (midnight UTC).
      - `duration_seconds` number required nullable
      - `thumbnail_url` string required nullable
      - `hashtags` array of string required
      - `sound` object required nullable
        - `id` string required
        - `title` string required nullable
        - `author` string required nullable Who made the sound, as the platform names them. Null when the platform did not say (Facebook never does).
        - `is_original` boolean required nullable True for the creator's own audio, false for a catalogue track. Null when not reported.
        - `commercial_use` boolean required nullable Cleared for use in ads (TikTok). Null when not reported.
      - `sound_mix` object required nullable Track volumes (TikTok). Null when not reported.
        - `sound_volume` number required nullable
        - `original_volume` number required nullable
        - `mix` string required nullable one of `voiceover`, `music_only`, `mixed` voiceover: only the creator's own track (may be speech); music_only: only the sound; mixed: both.
      - `creator` object required nullable
        - `id` string required
        - `handle` string required nullable
        - `name` string required
        - `follower_count` number required nullable YouTube: its rounded subscriber figure (527M is 527000000).
        - `avatar_url` string required nullable Our archived copy, else the platform's URL, which may expire: download it rather than store the link.
        - `verified` boolean required nullable The verified badge, from the latest profile read, else this video's. Null when unreported.
      - `region` string required nullable Where the video was posted, as the platform reports it (a country code on TikTok). Null when not reported.
      - `language` string required nullable Caption language, ISO 639-1, e.g. `en`: declared by TikTok; on Instagram declared or detected from the caption or transcript. Null when unknown.
      - `title` string required nullable The video's own title (YouTube, Facebook). Null when none or not reported.
      - `commerce` object required nullable What the Platform declares, never inferred from the content. A flag is null when not reported, never false; the object is null when nothing was.
        - `is_ad` boolean required nullable The Platform marks the video as an ad (TikTok, Instagram).
        - `paid_partnership` boolean required nullable The Platform marks a paid partnership (TikTok, Instagram; on YouTube, its "Includes paid promotion" label).
        - `affiliate` boolean required nullable Creator earns commission (TikTok, Instagram).
        - `shop_url` string required nullable The product link the video carries (TikTok Shop).
        - `anchors` array of object required The links the video carries under its caption (an editing template, a product, a place). Empty when none were reported.
          - `kind` string required The Platform's own anchor type id, e.g. `54`.
          - `label` string required What the anchor shows, e.g. `CapCut · Editing made easy`.
        - `products` array of object required nullable Every TikTok Shop product the video tags, in TikTok's order; group by `id` to find videos selling the same product. Empty when none; null off TikTok. No price: no source sends it.
          - `id` string required TikTok Shop's product id.
          - `label` string required The product name TikTok shows on the video.
          - `url` string required The product's TikTok Shop page.
        - `seller_ids` array of string required nullable The TikTok Shop sellers of those products. Null when not reported (some TikTok reads).
        - `sales_event` string required nullable The TikTok Shop sales event the video is tagged in, e.g. `BLACK FRIDAY`. Null when none or not reported.
      - `people` object required nullable Accounts the Video mentions or names: tagged users or TikTok mention entities first, then @handles typed in the caption. Null when none.
        - `mentions` array of string required Handles the caption mentions (lowercased).
        - `collaborators` array of object required Co-authors the Platform names on the Video (an Instagram collab, a Facebook collaborator).
          - `handle` string required nullable
          - `name` string required nullable
      - `location` object required nullable The place tagged on the Video (Instagram, TikTok). Not `region`. Null when none is tagged or the read did not say.
        - `id` string required nullable The Platform's own place id. Null when not sent.
        - `name` string required The place, e.g. `Central Park, New York`.
      - `topics` object required nullable Platform-declared topics. Null when the Platform reported none.
        - `keywords` array of string required The creator's own tags (YouTube).
        - `genre` string required nullable The Platform's category, e.g. `Education` (YouTube).
        - `labels` array of string required The Platform's own category labels (TikTok) or topic pills (Instagram).
      - `suggested_searches` array of string required nullable TikTok's suggested searches for the Video, in order. Not the creator's tags (topics.keywords). Null: not reported.
      - `on_screen_text` array of object required nullable TikTok: text added with TikTok's text tool, in order, with when it shows (ms) when known. Not text burned in by another editor. []: none. Null: not reported.
        - `text` string required
        - `start_ms` integer required nullable
        - `end_ms` integer required nullable
      - `chapters` array of object required nullable The creator's chapters, else YouTube's auto ones, in order (YouTube). Null: none or not reported.
        - `title` string required
        - `start_seconds` number required Where the chapter starts, in seconds from the start.
        - `auto` boolean required nullable True: YouTube made it. Null: not reported.
      - `ai_generated` boolean required nullable The Platform labels the video AI-generated (TikTok). Null when not reported.
      - `is_pinned` boolean required nullable Pinned to the top of the creator's Instagram reels tab. Null when no reels tab was read.
      - `format` string required nullable one of `short`, `long`, `photo`, `photo_carousel` Kind of Video (YouTube: short or long). Null when not reported.
      - `slides` object required nullable A carousel's slides. URLs are the Platform's and may expire. Null on a single video or photo.
        - `count` number required
        - `items` array of object required
          - `kind` string required one of `image`, `video`
          - `url` string required
      - `reactions` object required nullable Reactions by kind (Facebook); `likes` is their total. A kind is 0 if none, null if unknown. Null when not reported.
        - `like` number required nullable
        - `love` number required nullable
        - `haha` number required nullable
        - `wow` number required nullable
        - `care` number required nullable
        - `sad` number required nullable
        - `angry` number required nullable
      - `most_replayed` object required nullable YouTube's rewatch heatmap. Null: none or unreported.
        - `peak_seconds` number required The top marker's start.
        - `markers` array of object required
          - `start_seconds` number required
          - `duration_seconds` number required
          - `intensity` number required 0-1.
      - `audio_languages` object required nullable YouTube audio tracks: original language and dubs, no region (en, zh-Hans). Null: no tracks.
        - `original` string required nullable
        - `dubbed` array of string required
      - `is_sponsored` boolean required nullable Ad/partner/affiliate flag, #ad or #…partner tag, or a brand collaborator. Null: unchecked.
      - `sponsor` string required nullable The sponsoring brand's handle when is_sponsored.
      - `snapshot` object required nullable Deprecated: use `engagement`.
        - `at` string required
        - `views` number required nullable
        - `likes` number required nullable
        - `comments` number required nullable
        - `shares` number required nullable
        - `saves` number required nullable
      - `engagement` object required nullable A count the platform did not report is null, never 0.
        - `views` number required nullable On Facebook, plays: the count Facebook shows on a reel (since 2026-11-17; before, a lower views figure).
        - `likes` number required nullable
        - `comments` number required nullable
        - `shares` number required nullable
        - `saves` number required nullable
        - `at` string required
      - `scores` object required nullable Null when the creator has no baseline yet.
        - `outlier` number required nullable Views over the creator's median views.
        - `outlier_p90` number required nullable
        - `percentile` number required nullable Where this video sits in the creator's own sample, 0-100.
        - `velocity` object required nullable
          - `views_per_hour` number required
          - `window` string required
          - `since` string required nullable When the window starts.
        - `engagement_rate` number required nullable This video's reported interactions (likes, comments, shares, saves) over its views. Null when unknown.
        - `anomaly` boolean required nullable True when `engagement_rate` is under 20% of the baseline's, as paid or boosted views read. Null when unknown.
        - `reason` string required nullable always `aged_out` `aged_out` when the video is over 30 days old and the view Scores are null.
        - `baseline` object required The yardstick every Score on this creator is measured against.
          - `median_views` number required
          - `p90_views` number required
          - `engagement_rate` number required nullable
          - `posts_per_week` number required nullable
          - `sample` integer required
          - `confidence` string required one of `high`, `low`
          - `source` string required one of `videos`, `follower_tier`
          - `computed_at` string required nullable
          - `stale` boolean required True past 7 days; the next lookup refreshes it.
      - `coverage` string always `partial` Present only where the platform's index is best-effort.
      - `focus` object
        - `verdict` string required one of `in_focus`, `off_focus`, `unjudged` `unjudged`: the Video could not be judged (or is not judged yet) and is shown.
        - `reason` string required
    - `off_focus_count` integer required Videos hidden as off focus.
    - `focus` object required
      - `total` integer required Videos read.
      - `in_focus` integer required
      - `unjudged` integer required Shown, but not counted in focus.
      - `summary` string required "N of M in focus".
      - `stats` object required Stats over the in-focus Videos only.
        - `sampled_videos` integer required
        - `views_total` number required
        - `views_median` number required nullable
        - `views_max` number required nullable
        - `likes_total` number required
        - `comments_total` number required
        - `engagement_rate` number required nullable
  - `recent_videos` object Only on a Creator Tracker: its newest Videos, every one with `focus: { verdict, reason }`.
    - `videos` array of object required The Creator's newest Videos, newest first: in-focus and unjudged ones; with `include_off_focus=true` every Video, each with `focus`.
      - `platform` string required
      - `id` string required
      - `url` string required nullable
      - `description` string required nullable Null when the read fetched no caption.
      - `posted_at` string required nullable YouTube: exact when its web player answered, else the date only (midnight UTC).
      - `duration_seconds` number required nullable
      - `thumbnail_url` string required nullable
      - `hashtags` array of string required
      - `sound` object required nullable
        - `id` string required
        - `title` string required nullable
        - `author` string required nullable Who made the sound, as the platform names them. Null when the platform did not say (Facebook never does).
        - `is_original` boolean required nullable True for the creator's own audio, false for a catalogue track. Null when not reported.
        - `commercial_use` boolean required nullable Cleared for use in ads (TikTok). Null when not reported.
      - `sound_mix` object required nullable Track volumes (TikTok). Null when not reported.
        - `sound_volume` number required nullable
        - `original_volume` number required nullable
        - `mix` string required nullable one of `voiceover`, `music_only`, `mixed` voiceover: only the creator's own track (may be speech); music_only: only the sound; mixed: both.
      - `creator` object required nullable
        - `id` string required
        - `handle` string required nullable
        - `name` string required
        - `follower_count` number required nullable YouTube: its rounded subscriber figure (527M is 527000000).
        - `avatar_url` string required nullable Our archived copy, else the platform's URL, which may expire: download it rather than store the link.
        - `verified` boolean required nullable The verified badge, from the latest profile read, else this video's. Null when unreported.
      - `region` string required nullable Where the video was posted, as the platform reports it (a country code on TikTok). Null when not reported.
      - `language` string required nullable Caption language, ISO 639-1, e.g. `en`: declared by TikTok; on Instagram declared or detected from the caption or transcript. Null when unknown.
      - `title` string required nullable The video's own title (YouTube, Facebook). Null when none or not reported.
      - `commerce` object required nullable What the Platform declares, never inferred from the content. A flag is null when not reported, never false; the object is null when nothing was.
        - `is_ad` boolean required nullable The Platform marks the video as an ad (TikTok, Instagram).
        - `paid_partnership` boolean required nullable The Platform marks a paid partnership (TikTok, Instagram; on YouTube, its "Includes paid promotion" label).
        - `affiliate` boolean required nullable Creator earns commission (TikTok, Instagram).
        - `shop_url` string required nullable The product link the video carries (TikTok Shop).
        - `anchors` array of object required The links the video carries under its caption (an editing template, a product, a place). Empty when none were reported.
          - `kind` string required The Platform's own anchor type id, e.g. `54`.
          - `label` string required What the anchor shows, e.g. `CapCut · Editing made easy`.
        - `products` array of object required nullable Every TikTok Shop product the video tags, in TikTok's order; group by `id` to find videos selling the same product. Empty when none; null off TikTok. No price: no source sends it.
          - `id` string required TikTok Shop's product id.
          - `label` string required The product name TikTok shows on the video.
          - `url` string required The product's TikTok Shop page.
        - `seller_ids` array of string required nullable The TikTok Shop sellers of those products. Null when not reported (some TikTok reads).
        - `sales_event` string required nullable The TikTok Shop sales event the video is tagged in, e.g. `BLACK FRIDAY`. Null when none or not reported.
      - `people` object required nullable Accounts the Video mentions or names: tagged users or TikTok mention entities first, then @handles typed in the caption. Null when none.
        - `mentions` array of string required Handles the caption mentions (lowercased).
        - `collaborators` array of object required Co-authors the Platform names on the Video (an Instagram collab, a Facebook collaborator).
          - `handle` string required nullable
          - `name` string required nullable
      - `location` object required nullable The place tagged on the Video (Instagram, TikTok). Not `region`. Null when none is tagged or the read did not say.
        - `id` string required nullable The Platform's own place id. Null when not sent.
        - `name` string required The place, e.g. `Central Park, New York`.
      - `topics` object required nullable Platform-declared topics. Null when the Platform reported none.
        - `keywords` array of string required The creator's own tags (YouTube).
        - `genre` string required nullable The Platform's category, e.g. `Education` (YouTube).
        - `labels` array of string required The Platform's own category labels (TikTok) or topic pills (Instagram).
      - `suggested_searches` array of string required nullable TikTok's suggested searches for the Video, in order. Not the creator's tags (topics.keywords). Null: not reported.
      - `on_screen_text` array of object required nullable TikTok: text added with TikTok's text tool, in order, with when it shows (ms) when known. Not text burned in by another editor. []: none. Null: not reported.
        - `text` string required
        - `start_ms` integer required nullable
        - `end_ms` integer required nullable
      - `chapters` array of object required nullable The creator's chapters, else YouTube's auto ones, in order (YouTube). Null: none or not reported.
        - `title` string required
        - `start_seconds` number required Where the chapter starts, in seconds from the start.
        - `auto` boolean required nullable True: YouTube made it. Null: not reported.
      - `ai_generated` boolean required nullable The Platform labels the video AI-generated (TikTok). Null when not reported.
      - `is_pinned` boolean required nullable Pinned to the top of the creator's Instagram reels tab. Null when no reels tab was read.
      - `format` string required nullable one of `short`, `long`, `photo`, `photo_carousel` Kind of Video (YouTube: short or long). Null when not reported.
      - `slides` object required nullable A carousel's slides. URLs are the Platform's and may expire. Null on a single video or photo.
        - `count` number required
        - `items` array of object required
          - `kind` string required one of `image`, `video`
          - `url` string required
      - `reactions` object required nullable Reactions by kind (Facebook); `likes` is their total. A kind is 0 if none, null if unknown. Null when not reported.
        - `like` number required nullable
        - `love` number required nullable
        - `haha` number required nullable
        - `wow` number required nullable
        - `care` number required nullable
        - `sad` number required nullable
        - `angry` number required nullable
      - `most_replayed` object required nullable YouTube's rewatch heatmap. Null: none or unreported.
        - `peak_seconds` number required The top marker's start.
        - `markers` array of object required
          - `start_seconds` number required
          - `duration_seconds` number required
          - `intensity` number required 0-1.
      - `audio_languages` object required nullable YouTube audio tracks: original language and dubs, no region (en, zh-Hans). Null: no tracks.
        - `original` string required nullable
        - `dubbed` array of string required
      - `is_sponsored` boolean required nullable Ad/partner/affiliate flag, #ad or #…partner tag, or a brand collaborator. Null: unchecked.
      - `sponsor` string required nullable The sponsoring brand's handle when is_sponsored.
      - `snapshot` object required nullable Deprecated: use `engagement`.
        - `at` string required
        - `views` number required nullable
        - `likes` number required nullable
        - `comments` number required nullable
        - `shares` number required nullable
        - `saves` number required nullable
      - `engagement` object required nullable A count the platform did not report is null, never 0.
        - `views` number required nullable On Facebook, plays: the count Facebook shows on a reel (since 2026-11-17; before, a lower views figure).
        - `likes` number required nullable
        - `comments` number required nullable
        - `shares` number required nullable
        - `saves` number required nullable
        - `at` string required
      - `scores` object required nullable Null when the creator has no baseline yet.
        - `outlier` number required nullable Views over the creator's median views.
        - `outlier_p90` number required nullable
        - `percentile` number required nullable Where this video sits in the creator's own sample, 0-100.
        - `velocity` object required nullable
          - `views_per_hour` number required
          - `window` string required
          - `since` string required nullable When the window starts.
        - `engagement_rate` number required nullable This video's reported interactions (likes, comments, shares, saves) over its views. Null when unknown.
        - `anomaly` boolean required nullable True when `engagement_rate` is under 20% of the baseline's, as paid or boosted views read. Null when unknown.
        - `reason` string required nullable always `aged_out` `aged_out` when the video is over 30 days old and the view Scores are null.
        - `baseline` object required The yardstick every Score on this creator is measured against.
          - `median_views` number required
          - `p90_views` number required
          - `engagement_rate` number required nullable
          - `posts_per_week` number required nullable
          - `sample` integer required
          - `confidence` string required one of `high`, `low`
          - `source` string required one of `videos`, `follower_tier`
          - `computed_at` string required nullable
          - `stale` boolean required True past 7 days; the next lookup refreshes it.
      - `coverage` string always `partial` Present only where the platform's index is best-effort.
      - `focus` object
        - `verdict` string required one of `in_focus`, `off_focus`, `unjudged` `unjudged`: the Video could not be judged (or is not judged yet) and is shown.
        - `reason` string required
    - `off_focus_count` integer required Videos hidden as off focus.
    - `focus` object required
      - `total` integer required Videos read.
      - `in_focus` integer required
      - `unjudged` integer required Shown, but not counted in focus.
      - `summary` string required "N of M in focus".
      - `stats` object required Stats over the in-focus Videos only.
        - `sampled_videos` integer required
        - `views_total` number required
        - `views_median` number required nullable
        - `views_max` number required nullable
        - `likes_total` number required
        - `comments_total` number required
        - `engagement_rate` number required nullable
- Option 2 object Returned instead of a Run when `estimate=true`. Nothing is charged; some operations add members.
  - `estimate_credits` integer required What the call would be charged, in Credits.
  - `cached` boolean required Whether a stored result can already answer. It does not change the price.

### 401 Unauthorized

Codes: `missing_authorization`, `invalid_key`, `key_revoked`, `key_expired`, `invalid_token`. The problem body and every code are on [Errors](https://www.shortsintel.com/docs/reference/errors).

### 402 Payment Required

`insufficient_balance` — the Balance cannot cover the quote. Nothing is judged.

Code: `insufficient_balance`. The problem body and every code are on [Errors](https://www.shortsintel.com/docs/reference/errors).

### 404 Not Found

Code: `not_found`. The problem body and every code are on [Errors](https://www.shortsintel.com/docs/reference/errors).

### 409 Conflict

`idempotency_conflict` — the same Idempotency-Key with a different payload.

Code: `idempotency_conflict`. The problem body and every code are on [Errors](https://www.shortsintel.com/docs/reference/errors).

### 429 Too Many Requests

`rate_limit_exceeded`, with `Retry-After`.

Code: `rate_limit_exceeded`. The problem body and every code are on [Errors](https://www.shortsintel.com/docs/reference/errors).

## Related guides

- [Pricing and estimates](https://www.shortsintel.com/docs/concepts/pricing-and-estimates): Credits, estimates and why a cached result costs the same as a fresh one.
- [Trackers](https://www.shortsintel.com/docs/concepts/trackers): Standing watches on a creator or an Advertiser: how a cycle runs, when it reports a change, and how to pause one.

## Request samples

curl:

```bash
curl -X POST "https://www.shortsintel.com/v1/trackers/trk_4b1e90c7aa/focus/preview" \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"focus":{"text":"text","must_mention":["must_mention"]}}'
```

TypeScript:

```typescript
const response = await fetch(
  "https://www.shortsintel.com/v1/trackers/trk_4b1e90c7aa/focus/preview",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sk_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      "focus": {
        "text": "text",
        "must_mention": [
          "must_mention"
        ]
      }
    }),
  },
);

if (!response.ok) {
  throw new Error(`ShortsIntel ${response.status}`);
}

const data = await response.json();
```

Python:

```python
import requests

response = requests.post(
    "https://www.shortsintel.com/v1/trackers/trk_4b1e90c7aa/focus/preview",
    headers={
        "Authorization": "Bearer sk_live_YOUR_KEY",
        "Content-Type": "application/json",
    },
    json={
        "focus": {
            "text": "text",
            "must_mention": [
                "must_mention",
            ],
        },
    },
)
response.raise_for_status()

data = response.json()
```

200 · `{ run, focus, sample }`; `sample` is null when the Tracker has no Sample yet. With `estimate=true`, the quote instead.

```json
{
  "run": {
    "id": "run_8f2c1ad04b",
    "kind": "focus_judgment",
    "status": "completed",
    "created_at": "2026-09-08T09:14:02.418Z",
    "completed_at": "2026-09-08T09:14:04.930Z",
    "charge_credits": 6,
    "list_price_credits": 6,
    "cached": false
  },
  "focus": {
    "text": "Hands-on tips for AI video tools. Not product comparisons.",
    "must_mention": []
  },
  "sample": null
}
```

[Previous Set or clear a tracker's focus](https://www.shortsintel.com/docs/reference/trackers/set-tracker-focus)[Next Read a target's snapshots](https://www.shortsintel.com/docs/reference/trackers/list-tracker-snapshots)
