llms.txt
+45 −23
https://www.shortsintel.com/llms.txt
− - Prices are in Credits. Free tools never charge: `get_research`, `list_trackers`, `get_tracker`, `set_tracker_state`, `set_tracker_intelligence`, `delete_tracker`, `get_changes`, `list_collections`, `create_collection`, `rename_collection`, `delete_collection`, `remove_from_collection`, `get_run`, `get_usage`, `get_balance`.− - For a paid tool, call it with `estimate=true` and tell the user the price first, unless they already approved it.− - For an open-ended question across a niche, call `research` once rather than many `search_videos` or `get_video` calls.− - [REST quickstart](https://www.shortsintel.com/docs/quickstart.md) — From no key to a completed Run: create a key, make the first call, read the envelope, poll a Run and price a call before you spend on it.− - [MCP quickstart](https://www.shortsintel.com/docs/mcp.md) — Connect Claude.ai, ChatGPT, Claude Code, Codex, Cursor or VS Code to the ShortsIntel MCP server. 30 tools for short-form video research, priced per operation.− - [Research](https://www.shortsintel.com/docs/concepts/research.md) — How an intent becomes a digest, why a research id is a run id, and how to re-slice what you collected for free instead of paying for it twice.− - [Trackers](https://www.shortsintel.com/docs/concepts/trackers.md) — Standing watches on a creator or a Meta or TikTok Advertiser: how a cycle runs, when it reports a change, and how to pause one.− - [Ads](https://www.shortsintel.com/docs/concepts/ads.md) — Searching Meta's Ad Library with its filters, what each Ad carries, the winner Score, Ad analysis, what is stored, and how an ad search is priced.− - [`GET /v1/research/{id}`](https://www.shortsintel.com/docs/reference/research/get-research.md) — Read a research's status. Free, forever. Collection is the only thing charged.− - [`GET /v1/research/{id}/videos`](https://www.shortsintel.com/docs/reference/research/list-research-videos.md) — Filter a research's videos. Free, forever, filtered or not. Collection is the only thing charged.− - [`GET /v1/research/{id}/creators`](https://www.shortsintel.com/docs/reference/research/list-research-creators.md) — Rank a research's creators. Free, forever, filtered or not. Collection is the only thing charged.− - [`GET /v1/research/{id}/hashtags`](https://www.shortsintel.com/docs/reference/research/list-research-hashtags.md) — Rank a research's hashtags. Free, forever, filtered or not. Collection is the only thing charged.− - [`GET /v1/research/{id}/sounds`](https://www.shortsintel.com/docs/reference/research/list-research-sounds.md) — Rank a research's sounds. Free, forever, filtered or not. Collection is the only thing charged.− - [`GET /v1/research/{id}/digest`](https://www.shortsintel.com/docs/reference/research/get-research-digest.md) — Read a research's digest. Free, forever. Collection is the only thing charged.− - [`POST /v1/ads/search`](https://www.shortsintel.com/docs/reference/ads/search-ads.md) — Search ad libraries. Meta: 1 credit per Ad delivered, the same when served from a recent advertiser observation, plus 20 credits per Ad analysed with `analyze`, computed or already stored; the estimate quotes `limit` Ads, all analysed up to the cap with `analyze`. TikTok: 3 credits per page.− - [`GET /v1/ads/meta/{library_id}`](https://www.shortsintel.com/docs/reference/ads/get-meta-ad.md) — Look up a Meta Ad by id. 3 credits, read live or from our stored copy (observed under 6 h ago, or removed from the library). With `analyze=true`, plus 20 credits, whether the analysis is computed or already stored.− - [`GET /v1/ads/tiktok/{ad_id}`](https://www.shortsintel.com/docs/reference/ads/get-tik-tok-ad.md) — Get a TikTok Ad. 3 credits.− - [`POST /v1/trackers`](https://www.shortsintel.com/docs/reference/trackers/create-tracker.md) — Start tracking a target. The first cycle is charged on create: 6 credits for a creator, 3 credits for a hashtag, 6 credits for a sound, 3 credits for a keyword, 30 credits for an advertiser, plus 20 credits per new video when `intelligence` is on (per new Ad, on its own Run, for an advertiser). A TikTok advertiser cycle includes 10 new Ads' detail reads, then 3 credits each; the estimate and Balance − - Error codes, one page each: [missing_authorization](https://www.shortsintel.com/docs/reference/errors/missing_authorization.md), [invalid_key](https://www.shortsintel.com/docs/reference/errors/invalid_key.md), [key_revoked](https://www.shortsintel.com/docs/reference/errors/key_revoked.md), [invalid_token](https://www.shortsintel.com/docs/reference/errors/invalid_token.md), [organization_not_selected](https://www.shortsintel.com/docs/reference/errors/organization_not_selected.md), [organization− - `search_ads` — Search ad libraries (writes). Meta 1 credit per Ad delivered, +20 credits per Ad analysed (computed or stored); TikTok 3 credits per page− - `get_ad` — Get an Ad or Advertiser (writes). Ad 3 credits, +20 credits with analyze (Meta); Advertiser 15 credits (Meta or TikTok); TikTok Ad 3 credits− - `act_on_collection` — Act on every member (writes). Free for pause, resume, intelligence; refresh is a cycle per member: creator 6, hashtag 3, keyword 3, sound 6, advertiser 30 credits; +20 credits per new video analysed− ShortsIntel is a short-form video research tool that plugs into Claude and other AI Assistants. It finds the videos and ads winning on TikTok, Instagram Reels, YouTube Shorts, Facebook and Meta Ads, watches the videos themselves, ranks what is outperforming and hands the findings to the Assistant, which then works as a creative researcher and copywriter. Built for creative strategists and content marketers; charged per Run from prepaid Credits, no subscription. Founded in 2025 by Jackson Gathond+ - Prices are in Credits. Free tools never charge: `get_research`, `list_trackers`, `get_tracker`, `set_tracker_state`, `set_tracker_intelligence`, `delete_tracker`, `get_changes`, `get_tracker_ads`, `get_tracker_snapshots`, `get_ad_snapshots`, `list_collections`, `create_collection`, `rename_collection`, `delete_collection`, `remove_from_collection`, `get_run`, `get_usage`, `get_balance`.+ - A paid call under 50 Credits needs no quote: make it, with `max_credits=49` when the price depends on the inputs. Otherwise, or on `max_credits_exceeded`, call it with `estimate=true` and tell the user the price first, unless they already approved it.+ - For an open-ended question across a niche, call `research` once rather than many `search_videos` or `get_video` calls; for named Creators, `breakdown`.+ - Read `engagement` (Videos, comments) and `stats` (Creators); null is unreported, not 0.+ - [REST quickstart](https://www.shortsintel.com/docs/quickstart.md) — Create a key, make your first call, read the Run it returns, poll a slow call and price a call before you spend on it.+ - [MCP quickstart](https://www.shortsintel.com/docs/mcp.md) — Connect Claude.ai, ChatGPT, Claude Code, Codex, Cursor or VS Code to the ShortsIntel MCP server. 34 tools for short-form video research, priced per operation.+ - [Research](https://www.shortsintel.com/docs/concepts/research.md) — Ask one open question across a niche and get a digest with its evidence: how a research works, what it costs, and how to read it back for free.+ - [Creator Breakdown](https://www.shortsintel.com/docs/concepts/creator-breakdown.md) — What works for named Creators, by each one's normal.+ - [Trackers](https://www.shortsintel.com/docs/concepts/trackers.md) — Standing watches on a creator or an Advertiser: how a cycle runs, when it reports a change, and how to pause one.+ - [Ads](https://www.shortsintel.com/docs/concepts/ads.md) — Search Meta's, TikTok's and Google's ad libraries: the filters, what each Ad carries, the winner Score, Ad analysis, what is stored, and what a search costs.+ - [Objects and schemas](https://www.shortsintel.com/docs/concepts/objects.md) — The objects every endpoint shares, one JSON Schema each, and the rule that an unreported count is null.+ - [`GET /v1/research/{id}`](https://www.shortsintel.com/docs/reference/research/get-research.md) — Read a research's status. Free, forever. Only collection is charged.+ - [`GET /v1/research/{id}/videos`](https://www.shortsintel.com/docs/reference/research/list-research-videos.md) — Filter a research's videos. Free, forever, filtered or not. Only collection is charged.+ - [`GET /v1/research/{id}/creators`](https://www.shortsintel.com/docs/reference/research/list-research-creators.md) — Rank a research's creators. Free, forever, filtered or not. Only collection is charged.+ - [`GET /v1/research/{id}/hashtags`](https://www.shortsintel.com/docs/reference/research/list-research-hashtags.md) — Rank a research's hashtags. Free, forever, filtered or not. Only collection is charged.+ - [`GET /v1/research/{id}/sounds`](https://www.shortsintel.com/docs/reference/research/list-research-sounds.md) — Rank a research's sounds. Free, forever, filtered or not. Only collection is charged.+ - [`GET /v1/research/{id}/digest`](https://www.shortsintel.com/docs/reference/research/get-research-digest.md) — Read a research's digest. Free, forever. Only collection is charged.+ ### [Creator Breakdown](https://www.shortsintel.com/docs/reference/breakdowns.md)+ - [`POST /v1/breakdowns`](https://www.shortsintel.com/docs/reference/breakdowns/create-breakdown.md) — Run a Creator Breakdown. 9 credits per Creator plus 20 credits per analysed Video, at most 4,090 credits; failed ones are free.+ - [`GET /v1/breakdowns/{id}`](https://www.shortsintel.com/docs/reference/breakdowns/get-breakdown.md) + `/videos`, `/creators`, `/hashtags`, `/sounds`, `/digest`, `POST /refresh`: same shapes and prices as `/v1/research/{id}` and its sub-routes.+ - [`POST /v1/videos/lookup/batch`](https://www.shortsintel.com/docs/reference/videos/lookup-videos.md) — Look up many videos by URL. 3 credits per video, charged only for the distinct URLs that succeed. `estimate=true` quotes them all.+ - [`GET /v1/videos/{platform}/{id}/snapshots`](https://www.shortsintel.com/docs/reference/videos/list-video-snapshots.md) — Read a video's metric history. Free.+ - [`POST /v1/creators/lookup/batch`](https://www.shortsintel.com/docs/reference/creators/lookup-creators.md) — Look up many creators. 6 credits per creator, charged only for the distinct pairs that succeed.+ - [`POST /v1/ads/search`](https://www.shortsintel.com/docs/reference/ads/search-ads.md) — Search ad libraries. Meta: 1 credit per Ad delivered, plus 20 credits per Ad analysed with `analyze`, computed or already stored; the estimate quotes `limit` Ads, analysed up to the cap. TikTok: 3 credits per page. Google: 3 credits per Ad, plus analysis.+ - [`GET /v1/ads/meta/{library_id}`](https://www.shortsintel.com/docs/reference/ads/get-meta-ad.md) — Look up a Meta Ad by id. 3 credits, read live or from our stored copy (observed under 6 h ago, or removed from the library). With `analyze=true`, plus 20 credits, computed or stored.+ - [`GET /v1/ads/tiktok/{ad_id}`](https://www.shortsintel.com/docs/reference/ads/get-tik-tok-ad.md) — Get a TikTok Ad. 3 credits. With `analyze=true`, plus 20 credits, whether the analysis is computed or already stored.+ - [`GET /v1/ads/google/{creative_id}`](https://www.shortsintel.com/docs/reference/ads/get-google-ad.md) — Look up a Google Ad. 3 credits, plus 20 credits with `analyze=true`.+ - [`GET /v1/ads/tiktok/{ad_id}/intelligence`](https://www.shortsintel.com/docs/reference/ads/get-tik-tok-ad-intelligence.md) — Get a TikTok Ad's analysis. Free.+ - [`GET /v1/ads/google/{creative_id}/snapshots`](https://www.shortsintel.com/docs/reference/ads/list-google-ad-snapshots.md) — Read a Google Ad's history. Free.+ - [`POST /v1/trackers`](https://www.shortsintel.com/docs/reference/trackers/create-tracker.md) — Start tracking a target. The first cycle is charged on create: 6 credits for a creator, 3 credits for a hashtag, 6 credits for a sound, 3 credits for a keyword, 30 credits for an advertiser, plus 20 credits per new video when `intelligence` is on (per new Ad, on its own Run, for an advertiser). A TikTok advertiser cycle includes 10 new Ads' detail reads, then 3 credits each; the estimate and Balance + - [`GET /v1/trackers/{id}/ads`](https://www.shortsintel.com/docs/reference/trackers/list-tracker-ads.md) — List stored Ads. Free.+ - Error codes: [Errors](https://www.shortsintel.com/docs/reference/errors.md), every code with its status and a link to its page.+ - `breakdown` — Creator Breakdown (writes). 9 credits per creator plus 20 credits per video analysed, at most 4,090 credits+ - `search_ads` — Search ad libraries (writes). Meta 1 credit per Ad delivered; TikTok 3 credits per page; Google 3 credits per Ad; +20 credits per Ad analysed+ - `get_ad` — Get an Ad or Advertiser (writes). Ad 3 credits, +20 credits with analyze; Advertiser 15 credits+ - `get_tracker_ads` — Get a tracker's stored Ads (read-only). Free+ - `get_tracker_snapshots` — Get a tracker's history (read-only). Free+ - `get_ad_snapshots` — Get an Ad's history (read-only). Free+ - `act_on_collection` — Bulk-update a collection's trackers (writes). Free for pause, resume, intelligence; refresh is a cycle per member: creator 6, hashtag 3, keyword 3, sound 6, advertiser 30 credits; +20 credits per new video analysed+ ## Platform APIs