find_animation_titlesFind animated SERIES and FILMS (animation library only — mostly anime, plus Western animation) that fit what the user is making — by a story brief in plain words ("a quiet coming-of-age story about two sisters in a seaside town, bittersweet, summer"), by a title it should be like (like: "Akira"), by a LOOK (an image or frame ids — titles whose frames look like it), and/or by genre, theme, style, studio, movie/series and year. Signals combine. Returns each title with studio, director, genres, themes, its look, a synopsis, a poster, and for a look search the frames that matched.
find_by_craftFind frames by specific cinematography craft attributes — lens character, shot size, visual style, setting, time of day, director, or year range. All optional; combine to narrow. Use this to refine a search precisely.
find_similarFind frames visually/semantically similar to a given frame id (from a prior result). Use this to pull more references like one the user shortlisted.
get_animation_sequenceA frame in its sequence: the shots just before and after it in the same episode / film, in order, each with its still and caption — to see how a moment is built, or to lay a beat out across several canvas panels. With clips: true, each shot's clip plus the continuous "run" video that covers them (run_url, with from/to seconds).
get_animation_titleOne anime series or film in depth, by slug or name: synopsis, studio and key credits, main characters, genres, themes, its look, the trailer, how many shots are indexed, titles with a similar look and a similar story, and sample frames spread across it (frames: 0–24, default 6).
get_commercialThe full breakdown of one commercial by id: idea, logline, tagline, product, audience, every credit by role (director, agency, production company, DP, editor, music, post, sound, VFX), every award (show, year, level, category), craft numbers (shots, average shot length, cuts per minute, when the product / brand / emotional peak / end card land), the script with timings, and the shot list (caption, tags and still per shot; with clips: true, each shot's clip too).
get_frame_detailsGet the full metadata, a preview image and the FrameThrower link for a single frame id. For the full-resolution file or the depth map (camera geometry for image generation), call get_frame_image.
get_frame_imageOne frame's image at a paid size, as a link valid for an hour: "full" = the original full-resolution file (5 credits), "large" = 1280px (2), "depth" = the precomputed depth map, ControlNet-ready (2). Search results show a preview only — use this when the user wants the actual image for a deck, document, download or an image-generation pipeline.
search_animation_framesFind frames in FrameThrower's ANIMATION library — animated series and films only, never live-action (mostly anime, plus Western animation; the whole of every title, not a sample) for a scene, a moment or a CHARACTER LOOK, described in plain words: "a girl on a rooftop at dusk watching the city lights", "two kids running through a summer field", "a tall man with a scarred face and a long black coat, rain". Narrow by title, genre, theme, style (80s cel, watercolour, neon night…), studio, movie/series and year. Each frame has a caption of what is in it, a 640px still for looking at, the full-size
search_commercial_shotsFind individual SHOTS inside commercials by what is in the frame ("hand pouring beer in slow motion", "car drifting at night in the rain", "family laughing at a kitchen table"), with shot tags (size, angle, setting, time of day, lighting, mood, people, product / logo visible) and any commercial-level filter (brand, director, agency, award show, year…). Each shot has its still, its tags and a link to the exact moment; with clips: true, also a short clip of just that shot.
search_commercialsFind whole COMMERCIALS (TV / online spots) in FrameThrower's ads library by idea, story or brief ("two rival neighbours outdo each other at Christmas", "a product demo told as a heist") and/or by facts: brand, director, agency, production company, DP, editor, award show and level, year, industry, market, tone, genre, structure, season. Without a query it lists matching spots, award winners first. Returns each spot with brand, title, year, credits, best award, logline, a still and a link to watch it.
search_framesSearch the FrameThrower cinematography reference library by concept, mood, color, composition, or scene. Returns reference frames with film/credits metadata, a preview image and a link to view on FrameThrower. For the full-resolution file or the precomputed depth map, call get_frame_image with the frame id.
