Search skmtc…
⌘K
Docs
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Generate
Filter operations
ads
3
alerts
9
apiKeys
5
audience
1
brands
62
briefs
3
categories
10
collections
9
creatives
15
get
/v1/creatives/angles
Creative angles across the corpus (or a category): brands and live ads carrying each, its weekly series and the weekly count of brands adopting it; with `brandId`, the brand's own creatives and ads per angle.
get
/v1/creatives/angles/{angle}/adoption
One angle's weekly adoption, oldest first: new brands adopting it, cumulative, brands active with it.
get
/v1/creatives/mix
The tag mix of the creatives of a category or a brand: creatives per value of format, narrative form, speaker, presenter and offer in creative, with strata for reweighting.
get
/v1/creatives
Archived creative assets for an ad, or for a brand's attributed ads.
get
/v1/creatives/{creativeId}
One archived creative asset.
get
/v1/ads/{adId}/creatives
Every archived creative asset of one ad.
get
/v1/creative-records
Search creative records (one per stored file, not per ad) by brand or category, analysis depth, media kind, language, speech kind, any of the values of each closed field, words said or written on screen, and numeric ranges; most live ads first. Counts are ads carrying a file, never spend.
get
/v1/creative-records/{creativeKey}
One creative record by its key or a prefix of at least ten characters: media facts with frame times, the transcript with corrections, the classification, and the corpus join (ads carrying it, live ads, first start, landing page, creator-run). An ambiguous prefix is a conflict. Opening a record that is not rich yet queues its rich pass (`intel.rich` = pending); while it is pending the answer is sent with `cache-control: no-store`, so poll it every few seconds until `ready` or `unavailable`.
get
/v1/creative-records/{creativeKey}/similar
The creatives that look most like one, closest first: each as creatives.search lists it, with `similarity` (1 − the cosine distance between the two image embeddings; a near-duplicate is above 0.95). The key may be a prefix of at least ten characters. `scope` compares against every brand, the creative's own brand only, or every other brand. Only creatives with an embedding are compared; a creative with none yet is not found.
get
/v1/creative-search/text
The creatives that best match a description of what they show ("woman pouring iced coffee in a kitchen"), closest first, each as creatives.search lists it with `similarity`. It matches what the creative looks like, not its words: search the transcript and on-screen text with creatives.search `q`. Only creatives with an embedding are searched. A daily budget caps these searches across the API; past it the answer is 429 until the next UTC day.
get
/v1/creative-search/image
The creatives that look most like a picture, closest first, each as creatives.search lists it with `similarity`. `image_url` is an https URL of a JPEG, PNG or WebP of at most 5 MB. Crop a screenshot to the creative itself first: in the bake-off, uncropped phone screenshots found their creative 10 times in 30, cropped ones 30 in 30. Only creatives with an embedding are searched. A daily budget caps these searches across the API; past it the answer is 429 until the next UTC day.
post
/v1/workspaces/{ws}/creative-search/image
creatives.searchByImage for a picture sent in the request instead of linked: `image` is the base64 of a JPEG, PNG or WebP of at most 5 MB, `mime_type` its type. Crop a screenshot to the creative itself first (uncropped phone screenshots found their creative 10 times in 30 in the bake-off, cropped ones 30 in 30). Only creatives with an embedding are searched. A daily budget caps these searches across the API; past it the answer is 429 until the next UTC day.
get
/v1/creative-records/batch
creatives.record for many creatives in one read, by full key: each record as creatives.record answers it, in the order asked. A key no stage holds yet, or whose brand is not public, is left out.
get
/v1/creative-coverage
How far the pipeline has taken a brand's creative files (or every public brand's), against its measured file count, and each closed field's values over the described files — the denominators every creative share is printed with.
get
/v1/brand-creative-coverage
creatives.coverage for many brands in one read: each brand's coverage as creatives.coverage answers it. Every public brand asked is answered, in the order asked.
me
1
notes
3
operators
4
pages
5
radar
9
rankings
17
reports
3
system
3
tools
7
creatives
Copy
Copy Markdown
Copy Markdown
Copying…
Copied
Copy failed
Changes to One angle's weekly adoption, oldest first: new brands adopting it, cumulative, brands active with it.
get
/v1/creatives/angles/{angle}/adoption
Oct 19, 2026
4fbe9d681caf
Revision changes
info
endpoint added