Changelog

​

Your library

• Workspaces: spaces are now called workspaces. Get workspaces lists yours, and Get user boards takes workspace_id. /v1/spaces and space_id still work.
• Following: Get followed brands, all their ads in one feed with Get followed brands’ creatives, and Follow brand for any brand that’s in Adspo.
• Groups: Get groups, Get group creatives and Add brand to group.
• Boards and saving: Create board, Save creative and Add creative to board.

​

Finding creatives

• Search inside ads: q searches ad copy, video transcripts, on-screen text and landing pages, and search_in narrows it to one of them. See Searching inside ads.
• Visual format: visual_format finds a style of ad, such as Talking Head, Unboxing or Before & After, from the same list as the app’s filter.
• Both work on every creative feed, which now runs on the same search index as the Adspo app.

​

MCP server

• New tools: get_workspaces (replacing get_spaces), get_following, get_following_creatives, get_groups, get_group_creatives, save_creative, create_board, follow_brand, add_brand_to_group and send_feedback. The assistant only uses the ones that change your library when you ask it to.
• The creative tools take q, search_in and visual_format.
• When a limit is reached, the assistant is told when it can try again, so it can tell you.
• Existing connections keep working. Start a new chat to see the new tools.

​

Changed

• end_date now filters on when a creative was first seen, like start_date, so together they’re the window the creatives started running in. It used to filter on when they were last seen. To find creatives that have stopped running, use is_active=false.
• order_by=most_impressions is now only on Get brand creatives. Impression rank is within one brand, so it can’t order creatives across brands, and the other feeds return a 400 for it.
• An invalid category now returns the list of valid ones.

• Get creative returns one creative by its ID, with its ads when you pass include_ads=true.
• The MCP server’s creative tools show an interactive gallery in clients that support MCP Apps, such as Claude, and include each creative’s ads by default.
• New get_creative tool, which also fetches a video’s transcript.
• Every tool tells clients that it only reads data, and has a readable title.

• Creatives across all brands, with filters, and video transcripts
• Brand search, brand profiles and each brand’s creatives
• Your spaces, boards and the creatives on them
• Credit usage