OwlScran

Get creator snapshot

Returns the signed-in creator's current accounts, per-platform rollup metrics, 30-day follower growth when the calendar window is valid, connection issues, and existing OwlScran insight facts (highlights and watch-outs). Structured facts only. Does not show a card. For a general check-in, one call is enough. Never invent metrics.

Get post history

Returns posts with per-post metrics, captions, engagement rate, viral classification, and platform averages. Optional query searches title and caption. Every search word must match. Structured facts only. Does not show a card. Missing counts are unavailable, never zero. You choose which posts to use. OwlScran does not rank them for a brand.

Get growth history

Returns follower counts by calendar date plus a 30-day percent when that calendar window is valid. Structured facts only. Does not show a card. 30-day growth is calendar days, not the newest 30 observations. A timeline integrity failure errors; it is not empty history.

Get media kit activity

Returns existing media kit links, expiry, view counts, and last viewed time. Structured facts only. Does not show a card. Does not include IP, user agent, or city.

Get rate card

Returns rate cards, price lines, and the format catalog you can use to create a new card. Structured facts only. Does not show a card. Call this before changing prices or creating a card.

Show creator summary

Shows a compact OwlScran card of current connected-platform stats. Call only if a visual helps, and at most once per turn. Re-fetches OwlScran data. Pass platforms only. Never pass metric numbers.

Show content comparison

Shows a compact card comparing 2 to 4 of the creator's posts. Call only after you know which posts, and only if a visual helps. Pass OwlScran post ids from get_post_history. Re-fetches metrics. Never pass view counts or rates.

Show growth chart

Shows a compact follower-growth chart. Call only if a visual helps. Re-fetches the timeline. Pass platforms and an optional day window. Never pass follower counts or percents.

Show media kit card

Shows a compact media-kit card: link, expiry, views, and optional rates. Call only if a visual helps. Pass a share id or omit it to use the latest active kit. If rates are included and the kit does not store a rate card, pass rateCardId when the user has more than one. Re-fetches. Never pass view counts, URLs you invented, or prices.

Create a media kit

Creates a free media kit share link for a brand. A new link contains a snapshot of the selected information and expires after seven days. Existing links do not update when dashboard stats refresh. Pass postIds from get_post_history to put those videos on the kit instead of the saved featured set. postIds override includeFeaturedContent. If you set platforms, every selected video must be on one of those platforms. Extra platforms are not added. If an active kit for that brand exists, it is return

Create a rate card

Creates a new named rate card with the prices you pass. Call get_rate_card first so you can name formats from the catalog. Pass whole amounts in the card currency. You can send the same format at different quantities. If you pass formatId, it must match format and platform. This tool does not estimate rates. Does not show a card.

Update rate card prices

Use this when a user wants to change existing prices. Call get_rate_card first. Pass whole amounts in the card currency, not percentages. Name the platform or format. To change every price on one card, set applyToAll to true. If there is more than one rate card, pass rateCardId. If a line cannot be matched, change nothing. To make a new card, use create_rate_card. Does not show a card.