# Probe raw TikTok entities when packaged reads fall short

> Tier: recipe. Operating recipe: real tool sequence, core rules, known traps.

The raw entities endpoint for edge-case fields, used sparingly and cited precisely.

**Intent.** Direct entity access for fields the packaged tools do not surface.

## When to use

- A field exists in the API but not in packaged reads.

## When not to use

- Routine reads: packaged tools carry the conventions and the safety.

## Sources

Required: TikTok Ads

## Preconditions

- The account is ticked in the dashboard, confirmed via list_accounts.

## Inputs

- `window`: Analysis window. Default: last 30 days.

## Procedure

1. Probe the entity with the exact fields needed. — tools: `tiktok_get_entities_raw`
2. Cross-check one packaged read to anchor interpretation. — tools: `tiktok_get_campaigns`

## Decision rules

- **When** Raw and packaged disagree → **conclude** Trust neither yet: name the field and verify against the UI before concluding.

## Evidence requirements

- Every figure carries its account, metric and window.
- Anything below a readable sample size is reported as unjudged, not as zero.

## Human approval boundary

- The readout changes nothing. Any change it motivates goes through Safe Writes: preview, human confirmation, then apply.

## Failure modes

- Raw fields change with API versions: pin the version in the finding.

## Output

- **Readout**: The figures, with windows and accounts named.
- **Flags**: What deserves a deeper skill or a human decision.
