# Adside, for AI agents Updated: November 2026. This file is the agent-first reference behind https://www.adside.ai/agents. It lists every CLI command and every creative model live at the time of writing; the CLI itself is always current (`adside cli search ""` finds the command for any task, and `adside media models` lists live models with prices). Adside is an advertising platform with a CLI and an MCP server, built so an AI agent can run paid ads end to end: read and write on ad accounts (Meta, Google, LinkedIn, Reddit, X, plus TikTok and Snapchat reads), research competitors' live ads, generate static and video creatives across 60+ models, keep a per-brand memory (the brain), set up conversion tracking through Google Tag Manager, write reports, and schedule routines that keep running when no session is open. ## Install ``` npm install -g adside ``` Node.js 22 or later, on macOS, Linux or Windows. The CLI updates itself in the background; `adside update` forces it, and `ADSIDE_DISABLE_AUTOUPDATER=1` turns it off (it is off in CI). ## Log in ``` adside login ``` The human's browser opens and they approve once. The login is stored in the OS credential store. On a machine without a browser (SSH, CI, a cloud agent), either: - `adside login --no-browser` prints a link to open on any device, then takes the code it shows, or - use an API key: the human creates one in Adside under Settings → API keys (read-only is an option), then set `ADSIDE_API_KEY` and `ADSIDE_WORKSPACE_ID` (or pass `--workspace-id`). A key in `ADSIDE_API_KEY` takes precedence over a stored login. `adside whoami` shows who is signed in, their organizations and workspaces. With several workspaces (one per brand or client), `adside use` lists them and `adside use ""` sets the default. Nothing leaks between workspaces. ## Find commands For any task: ``` adside cli search "" ``` It prints the five closest commands as JSON and works without logging in. Then run the command you pick with `--help` for its flags. Every command prints JSON by default; add `--output text` for a human-readable summary. The full command reference below is for orientation; `cli search` is faster than scanning it. ## What agents use Adside for - **Read your ad accounts.** `adside reporting spend --period 7d` for cross-channel spend and conversions; `adside meta campaigns list`, `adside google-ads campaigns list` and the other platform areas for campaign detail; `adside audit list` for the history of changes with explanations. - **Analyze competitors' ads.** `adside research discover` finds competitors; `adside research feed --since 7d` is the cross-competitor feed of new ads; `adside research ads analysis` reads a creative analysis, `adside research ads transcript` a video transcript. - **Generate creatives.** `adside media recommend --task ""` picks up to three models with prices, parameters and the prompting guide; `adside media videos estimate` prices a request for free; `adside creatives create --brief ""` starts a drop in the brand's style; `adside creative-styles install` installs a style and its toolkit as agent skills. - **Keep the brain updated.** The brain is the per-brand memory: positioning, brand kit, competitors, what worked. `adside brain read`, `adside brain search`, `adside brain write`, `adside brain remember`. - **Launch and manage campaigns.** Draft campaigns, ad sets and ads on connected platforms; `adside meta campaign-readiness check` verifies a campaign can deliver before anything goes live. Changing live spend waits for human approval in Adside. - **Create landing pages.** Ask for a landing page for a campaign through Adside and get one in the brand, ready to publish. - **Set up tracking.** `adside google-tag-manager conversion-tracking audit` reads what a GTM container actually deploys; the same area sets tracking up. `adside reddit tracking-health check` and `adside x tracking-health check` verify measurement per platform. - **Write reports and artifacts.** `adside artifacts create` then `adside artifacts publish` makes documents, one-pagers and dashboards with sharing links; `adside reporting reports` for performance reports; `adside routines create` schedules a report that posts to Slack or email on its own. - **Brief the Slack agent.** `adside skills create` (or `generate` from a description) writes durable instructions that your agents and the @Adside Slack agent follow. - **Manage several clients.** One workspace per brand: `adside use ""` switches, or pass `--workspace-id` per command. Pricing is per brand with unlimited users and agents. ## Command reference 428 commands across 27 areas, as of November 2026. Login/logout, `use`, `update`, `whoami` and `cli search` come on top of these. ### adside ad-comments - `adside ad-comments capabilities` — Read moderation capabilities of connected Meta accounts - `adside ad-comments hide` — Hide an ad comment on Meta - `adside ad-comments list` — Read workspace ad comments grouped by post - `adside ad-comments reply` — Post a reply as the owning Page or Instagram account - `adside ad-comments unhide` — Restore a hidden ad comment on Meta ### adside artifacts - `adside artifacts create` — Create an empty artifact and its refinement thread; save its first version next - `adside artifacts delete` — Delete an artifact with its versions and its thread, and revoke its sharing link - `adside artifacts duplicate` — Copy an artifact's current version into a new artifact with its own thread, leaving the original alone - `adside artifacts get` — Read an artifact with its current version's files inline, ready to edit and send back with artifacts save - `adside artifacts list` — List the workspace's artifacts: the documents, one-pagers and dashboards the agent has written, most recently changed first - `adside artifacts prepare` — Download a version's archive to edit it in place rather than writing the document again. Takes a version number, a version ID, or `current` - `adside artifacts publish` — Make a version the one a sharing link serves. Asks for a confirmation when a link is already live - `adside artifacts rename` — Rename an artifact without touching any of its versions - `adside artifacts save` — Save a new version: text files inline, images by the ID of an asset of this workspace. No network, no remote URL. State --data-as-of... - `adside artifacts versions` — List an artifact's saved versions, newest first ### adside assets - `adside assets archive` — Archive an asset - `adside assets batch` — Look up assets in this workspace by ID - `adside assets delete` — Remove an asset and queue storage cleanup - `adside assets get` — Get an asset and its download URL - `adside assets import-url` — Import a public image or video URL into the asset library - `adside assets list` — List the workspace's assets, with filters and cursor pagination - `adside assets status` — Check asset processing and upload readiness - `adside assets tags list` — List the workspace's most-used asset tags - `adside assets tags update` — Add or remove asset tags - `adside assets transcription` — Request or read a video transcription - `adside assets update` — Update asset metadata - `adside assets uploads complete` — Publish an uploaded asset (safe to repeat) - `adside assets uploads create` — Reserve a media upload and return a single-file upload ticket - `adside assets upload` — Upload a local media file and publish it in the asset library - `adside assets download` — Download an asset to a new local file ### adside audiences - `adside audiences imports confirm` — Approve the exact mapping and send the customer list to the channel - `adside audiences imports create` — Prepare an audience import for explicit confirmation - `adside audiences imports get` — Read audience mapping and import progress - `adside audiences imports list` — List audience import outcomes - `adside audiences imports preview` — Inspect a CSV or spreadsheet before mapping audience identifiers - `adside audiences imports retry` — Resume a failed import with its immutable approved mapping ### adside audit - `adside audit get` — Read a campaign change or explicitly uncertain platform activity - `adside audit list` — Read campaign audit history with current access to explanations and sources ### adside boards - `adside boards bookmarks add-to-board` — Add a saved item to another board - `adside boards bookmarks list` — List saved ads and inspiration - `adside boards bookmarks move` — Move a saved item between boards - `adside boards bookmarks remove` — Remove a saved item or board membership - `adside boards bookmarks save` — Save an ad or inspiration item to a board - `adside boards create` — Create a board - `adside boards delete` — Delete a non-default board and its exclusive saved ads - `adside boards list` — List boards and saved-ad counts - `adside boards update` — Rename a board ### adside brain - `adside brain ingest create` — ingest Brain content and document ingestion - `adside brain ingest get` — job Brain content and document ingestion - `adside brain ingest list` — jobs Brain content and document ingestion - `adside brain list` — tree Brain content and document ingestion - `adside brain organization ingest create` — ingest Brain content and document ingestion - `adside brain organization ingest get` — job Brain content and document ingestion - `adside brain organization ingest list` — jobs Brain content and document ingestion - `adside brain organization uploads create` — upload Brain content and document ingestion - `adside brain read` — page Brain content and document ingestion - `adside brain remember` — Remember durable workspace facts in memory.md; applied in the background - `adside brain search` — Search Brain pages with bounded keyword scanning - `adside brain uploads create` — upload Brain content and document ingestion - `adside brain write` — write Brain content and document ingestion - `adside brain upload` — Upload a local document and start Brain ingestion ### adside brands - `adside brands creative-kit file` — Read one file from an immutable creative kit revision - `adside brands creative-kit get` — Read the current or a pinned creative kit revision from the workspace Brain - `adside brands details` — Read the default brand identity, products and capped website evidence - `adside brands get` — Get a brand kit - `adside brands list` — List brand kits ### adside characters - `adside characters create` — Create a character from 1 to 8 reference images of this workspace, best first; the first is the cover a talking avatar speaks from - `adside characters delete` — Delete a character; its reference images stay in the library, and media made with it is unchanged - `adside characters get` — Get a character by handle or ID, with its reference images in order - `adside characters list` — List the workspace's characters: the people and mascots that media generation keeps the same - `adside characters update` — Change a character; references replace the whole list, and null clears identity notes or the voice ### adside creative-styles - `adside creative-styles download` — Download the current zip of a creative style or the toolkit (`creative-styles install` downloads, verifies and unpacks both) - `adside creative-styles get` — Read one creative style (or the toolkit styles run on): its description, current version, sha256 and examples - `adside creative-styles list` — List the creative styles you can install: what each makes, what it needs, example outputs and typical media spend - `adside creative-styles install` — Install a creative style and the toolkit it runs on as skills for your agent, verified by sha256 ### adside creatives - `adside creatives add` — Add new creatives to an existing drop, or attach to the active drop-chat turn - `adside creatives by-request-id` — Recover the exact receipt of a create request without resubmitting - `adside creatives cancel` — Request cancellation of an exact run, retaining published work - `adside creatives comments create` — Pin feedback to a creative revision - `adside creatives comments delete` — Remove your unsubmitted creative feedback - `adside creatives comments update` — Update your unsubmitted creative feedback - `adside creatives copy` — Save export copy against an exact creative revision - `adside creatives create` — Start a creative drop; the sandbox reserves and generates its first batch. Omit creative count for Auto (brief quantity, otherwise 5). - `adside creatives edit` — Edit exact creative IDs, numbers or explicit all, using the active drop-chat turn when called from its resident - `adside creatives get` — Read stable creative IDs, numbers and current render revisions - `adside creatives list` — List creative drops and their current rendered previews - `adside creatives messages create` — Send a live drop conversation input - `adside creatives messages list` — Read the shared drop conversation - `adside creatives messages resume` — Explicitly resume a held conversation input - `adside creatives messages stop` — Stop an exact conversation input - `adside creatives meta prepare` — Check exact static creative revisions and missing formats for a Meta ad set; never generates or publishes - `adside creatives revert` — Restore a creative revision without changing other creatives - `adside creatives review` — Select or discard a creative for campaigns - `adside creatives revisions get` — Read a historical creative revision and its published media and copy - `adside creatives runs by-request-id` — Recover the exact receipt of an edit request without resubmitting - `adside creatives status` — Read an exact run's progress, terminal result and cleanup state - `adside creatives result` — Read an exact run's progress, terminal result and cleanup state ### adside credits - `adside credits balance` — Read the organization's media generation credit balance - `adside credits ledger` — List where the organization's media generation credit went, newest first ### adside google-ads - `adside google-ads accessible-customers list` — List the Google Ads customer account this client is connected to. Always returns that one account — other accounts the credentials can... - `adside google-ads ad-groups list` — List ad groups for a campaign with bids, status, and rotation settings. - `adside google-ads ads list` — List ads in an ad group with responsive search/display ad details including headlines, descriptions, and ad strength. - `adside google-ads asset-group-assets list` — List the assets linked to one Performance Max asset group, including each exact AssetGroupAsset resource name, field type, status, asset... - `adside google-ads asset-group-product-filters get` — Read and normalize Merchant Center product filters attached to one Performance Max asset group or every asset group in a campaign. - `adside google-ads asset-groups list` — List asset groups for a Performance Max campaign with status and final URLs. - `adside google-ads assets list` — List assets (text, image, video, callout, promotion) for a Google Ads account. Filter by type. Search for an identical CALLOUT or... - `adside google-ads audience-segments list` — List Google's ready-made audience segments (in-market, affinity, custom). These attach with `audience_id`, and only Performance Max,... - `adside google-ads campaign-ad-schedules get` — Read the complete recurring weekly ad schedule for a Google Ads campaign. Schedules use the account time zone; an empty result means... - `adside google-ads campaign-assets list` — List callout and promotion assets linked at campaign level. Use this before add_assets_to_campaign to avoid duplicate links, and use it... - `adside google-ads campaign-budgets list` — List campaign budgets for a Google Ads account with usage information. - `adside google-ads campaign-negative-keyword-lists list` — List the negative keyword lists attached to a campaign, with exact link resource names. Performance Max negatives apply to Search and... - `adside google-ads campaign-negative-keywords list` — List direct negative keyword criteria for one campaign. Shared list members are separate: use list_campaign_negative_keyword_lists.... - `adside google-ads campaign-performance get` — Get campaign performance metrics (impressions, clicks, cost, conversions, CTR, CPC). Supports date ranges and segmentation. - `adside google-ads campaigns list` — List campaigns with optional filters for status and type. Includes budget and bidding information. - `adside google-ads conversion-actions list` — List conversion actions, including primary_for_goal, ownership, and value settings. include_in_conversions_metric is deprecated; use... - `adside google-ads customer-conversion-goals list` — List existing account-default conversion goals, their exact resource names, and biddability. Customer goals affect all primary actions... - `adside google-ads customers get` — Get Google Ads account details including name, currency, timezone, and status. - `adside google-ads geo-targets get` — Search geographic targets by name (countries, regions, cities). Returns geo target constant IDs for campaign targeting. - `adside google-ads keyword-ad-groups suggest` — Ask Google to assign proposed keywords to the most relevant existing ad groups. Pass real IDs returned by list_ad_groups. Returns... - `adside google-ads keyword-ideas generate` — Generate new Google Search keyword ideas from up to 20 seed terms, a public page, both, or a whole site. Returns historical volume,... - `adside google-ads keyword-performance get` — Get keyword-level performance metrics with quality score breakdown (expected CTR, ad relevance, landing page experience). - `adside google-ads keyword-plan forecast` — Forecast cost plus clicks or conversions for a hypothetical Search keyword plan. Supports Manual CPC, Maximize Clicks and Maximize... - `adside google-ads keyword-plan-metrics get` — Google Keyword Planner data for keywords that are NOT yet in the account: average monthly searches, top-of-page bid range, competition... - `adside google-ads keywords list` — List keywords for an ad group with match type, quality score, and performance data. - `adside google-ads languages get` — Search Google Ads language constants by name or ISO code. Returns the language IDs used for language targeting and for keyword planning. - `adside google-ads negative-keyword-lists list` — List active reusable campaign negative keyword lists with member and campaign counts. Does not include account-level or brand lists. - `adside google-ads product-filter-values list` — List values currently present in a Performance Max campaign's Merchant Center inventory for a supported product filter attribute. Use... - `adside google-ads search-terms-report get` — Get actual search queries that triggered your ads (vs keywords you're targeting). Essential for negative keyword discovery. - `adside google-ads shared-negative-keywords list` — List all keyword members of one active shared negative keyword list, including exact resource names for removal. - `adside google-ads user-lists list` — List the account's remarketing lists — the people who visited the client's own site, as opposed to the ready-made segments Google... ### adside google-tag-manager - `adside google-tag-manager container-config get` — Read the tags, triggers and variables of a GTM container, from the published version (`live`) or from a draft workspace. `live` is what... - `adside google-tag-manager containers list` — List this client's Google Tag Manager containers. This is the entry point — no other GTM tool can run without a container path from... - `adside google-tag-manager conversion-tracking audit` — Audit what a GTM container actually deploys for conversion tracking, reading the **published** version. Covers the container half of the... ### adside linkedin - `adside linkedin ad-accounts get` — Get details of a LinkedIn Ad Account (name, status, currency, type, serving statuses) - `adside linkedin ad-accounts list` — Get the one LinkedIn Ad Account this client is connected to. Every other tool defaults to it, so you rarely need to pass account_id at... - `adside linkedin ad-segment get` — Look up one audience segment by its urn:li:adSegment: URN or id. Use this to name a segment found inside a campaign's or saved... - `adside linkedin ad-segments list` — List the audience segments an ad account owns: uploaded contact/company lists (type BULK) and website or engagement retargeting... - `adside linkedin analytics get` — Get performance analytics (impressions, clicks, cost, conversions, etc.) for LinkedIn ad entities. Group by account, campaign group,... - `adside linkedin audience-size-estimate get` — Estimate how many LinkedIn members match a targeting criteria. Returns a rounded member count. Call this BEFORE creating a campaign:... - `adside linkedin campaign-conversion-rules list` — List which conversion rules are attached to the given campaigns. Use this to answer 'why is this campaign reporting no conversions?' —... - `adside linkedin campaign-groups get` — Get the complete configuration for one LinkedIn campaign group, including schedule, budget, audit/version, objective, and delivery... - `adside linkedin campaign-groups list` — Search and list campaign groups for a LinkedIn Ad Account. Filter by status, name, or test flag. Supports cursor-based pagination.... - `adside linkedin campaign-readiness verify` — Verify campaign readiness by checking serving statuses, budget, targeting, and LinkedIn's cross-field campaign rules (objective/format,... - `adside linkedin campaigns get` — Get the complete configuration for one LinkedIn campaign, including targetingCriteria, version, schedule, optimization, budget, audit... - `adside linkedin campaigns list` — List campaigns for a LinkedIn Ad Account. Filter by status, type, campaign group, or name. Supports cursor-based pagination. Read... - `adside linkedin campaigns search` — Search campaigns with multiple filters (IDs, statuses, types, campaign groups). More flexible than list_campaigns for complex queries.... - `adside linkedin conversion-rule get` — Get one conversion rule by id, with its attribution settings, value, URL rules, associated campaigns and (for pixel rules) the Insight... - `adside linkedin conversions list` — List the conversion rules on a LinkedIn Ad Account: name, type, method, attribution settings, conversion value and enabled status.... - `adside linkedin creatives get` — Get a creative by ID: its status, review status, serving hold reasons — and the actual content of the ad, read from the post it points... - `adside linkedin creatives list` — Search and list creatives for a LinkedIn Ad Account. Filter by campaign, status, or creative IDs. Uses q=criteria finder with... - `adside linkedin demographic-insights get` — Get professional demographic analytics for LinkedIn ads. Break down performance by member company, industry, seniority, job title, job... - `adside linkedin lead-gen-forms get` — Get one lead gen form with the questions it asks and the tracking parameters it appends. Use it to tell a client what a form collects... - `adside linkedin lead-gen-forms list` — List the lead gen forms an ad account owns. A lead gen ad opens one of these inside LinkedIn, pre-filled from the member's profile,... - `adside linkedin matched-audiences get` — Check an audience built by uploading a contact or company list: whether LinkedIn has finished matching it, how many contacts were sent,... - `adside linkedin matched-audiences list` — List the audiences an ad account has built from uploaded contact or company lists, with their matching status and sizes. Use this to... - `adside linkedin performance compare` — Compare performance across multiple campaigns side-by-side. Returns analytics grouped by campaign for easy comparison of metrics like... - `adside linkedin saved-audiences get` — Get one saved audience with its full targeting criteria. Read this before update_saved_audience: an update REPLACES the criteria rather... - `adside linkedin saved-audiences list` — List an account's saved audiences (reusable targeting templates built in Campaign Manager). Each one carries a full targeting_criteria... - `adside linkedin targeting-entities get` — Resolve targeting URNs to human-readable names. Pass a list of URNs (e.g. urn:li:seniority:7, urn:li:industry:9) to get their display names. - `adside linkedin targeting-facets search` — Search for targeting entity values by facet type. Use typeahead search with a query string, or list all values for a facet. Returns URNs... - `adside linkedin video-upload get` — Status of a video upload started with upload_video: PENDING → PREPARING → UPLOADING → PROCESSING → AVAILABLE (or FAILED). This call... ### adside media - `adside media avatars cancel` — Cancel a talking avatar clip job; one a provider already accepted may still finish and is still charged - `adside media avatars estimate` — Price a talking avatar clip request without generating or charging - `adside media avatars generate` — Generate one talking avatar clip, charged at its priceUsd; the same requestId returns the same job - `adside media avatars get` — Read a talking avatar clip job, waiting up to waitSeconds for it to finish - `adside media avatars models` — List the talking avatar clip models, what each is best for, its supported values and prices - `adside media images cancel` — Cancel an image job; one a provider already accepted may still finish and is still charged - `adside media images estimate` — Price an image request without generating or charging - `adside media images generate` — Generate one image, charged at its priceUsd; the same requestId returns the same job - `adside media images get` — Read an image job, waiting up to waitSeconds for it to finish - `adside media images models` — List the image models, what each is best for, its supported values and prices - `adside media jobs list` — List the workspace's image, video, audio, avatar and lip-sync jobs, newest first - `adside media lipsync cancel` — Cancel a lip-sync clip job; one a provider already accepted may still finish and is still charged - `adside media lipsync estimate` — Price a lip-sync clip request without generating or charging - `adside media lipsync generate` — Generate one lip-sync clip, charged at its priceUsd; the same requestId returns the same job - `adside media lipsync get` — Read a lip-sync clip job, waiting up to waitSeconds for it to finish - `adside media lipsync models` — List the lip-sync clip models, what each is best for, its supported values and prices - `adside media music cancel` — Cancel a music track job; one a provider already accepted may still finish and is still charged - `adside media music estimate` — Price a music track request without generating or charging - `adside media music generate` — Generate one music track, charged at its priceUsd; the same requestId returns the same job - `adside media music get` — Read a music track job, waiting up to waitSeconds for it to finish - `adside media music models` — List the music track models, what each is best for, its supported values and prices - `adside media recommend` — Recommend up to three models for a task described in plain words, with why, ready-to-use parameters, the price and the model family's... - `adside media sounds cancel` — Cancel a sound effect job; one a provider already accepted may still finish and is still charged - `adside media sounds estimate` — Price a sound effect request without generating or charging - `adside media sounds generate` — Generate one sound effect, charged at its priceUsd; the same requestId returns the same job - `adside media sounds get` — Read a sound effect job, waiting up to waitSeconds for it to finish - `adside media sounds models` — List the sound effect models, what each is best for, its supported values and prices - `adside media speech cancel` — Cancel a speech clip job; one a provider already accepted may still finish and is still charged - `adside media speech estimate` — Price a speech clip request without generating or charging - `adside media speech generate` — Generate one speech clip, charged at its priceUsd; the same requestId returns the same job - `adside media speech get` — Read a speech clip job, waiting up to waitSeconds for it to finish - `adside media speech models` — List the speech clip models, what each is best for, its supported values and prices - `adside media videos cancel` — Cancel a video job; one a provider already accepted may still finish and is still charged - `adside media videos estimate` — Price a video request without generating or charging - `adside media videos generate` — Generate one video clip, charged at its priceUsd; the same requestId returns the same job - `adside media videos get` — Read a video job, waiting up to waitSeconds for it to finish - `adside media videos models` — List the video models, what each is best for, its supported values and prices - `adside media voices list` — List the stock voices a speech request may name, with what each suits and the models that offer it ### adside meta - `adside meta account-creatives analyze` — Analyze all creatives in an account to identify patterns, performance insights, and optimization opportunities. Provides summary... - `adside meta account-pages get` — List the Facebook Pages usable for ads on the given ad account: every Page the person who connected Meta can advertise with (ads access... - `adside meta account-pixels get` — List pixels/datasets available to this client's connected ad account, including ones with no attached ad sets. Returns IDs, names,... - `adside meta account-setup verify` — Check Meta account access, active status, funding visibility, promotable Pages and spending capacity. Unknown prerequisites prevent... - `adside meta account-spend-limit get` — Read the Meta ad account's spending limit and how much has been spent toward it. When the limit is reached Meta stops delivery for EVERY... - `adside meta ad-creative get` — Get a single ad creative by ID with full details including copy, media, and Advantage+ Creative (asset_feed_spec) data. Use this to... - `adside meta ad-images get` — Retrieve ad images from a Meta ad account. Returns image URLs, dimensions, and hashes. Use to get image URLs for displaying ad creatives... - `adside meta ad-sets get` — Retrieve details for a single ad set including its targeting, budget, optimization goal, and schedule. To duplicate it, pass this ad set... - `adside meta ad-sets list` — List all ad sets for a given campaign or ad account. Filter by status and paginate results. Returns ad set details including budget,... - `adside meta ads get` — Retrieve details for a single ad including its name, status, ad set, campaign, and creative. - `adside meta ads list` — List all ads for a given campaign, ad set, or ad account. Filter by status and paginate results. Returns ad details including creative,... - `adside meta ads preview` — Generate HTML preview of how an ad creative will appear in different placements and formats. Useful for testing creative appearance... - `adside meta api-compliance check` — Check if your creative parameters are compliant with current Meta Marketing API (v25.0) requirements. Identifies deprecated features and... - `adside meta api-reference get` — Get a reference guide for valid Meta Marketing API parameters, including allowed optimization goals, billing events, and their valid... - `adside meta attribution-data get` — Retrieve attribution data with conversion tracking across multiple attribution windows (1-day click, 7-day click, 1-day view). Returns... - `adside meta audience-details get` — Get detailed information about a specific audience including size estimates, delivery status, operation status, data source, and... - `adside meta audience-size estimate` — Estimate the potential reach of a targeting specification. Returns monthly and daily active user estimates with targeting recommendations. - `adside meta audiences list` — List custom and lookalike audiences for an ad account. Supports filtering by type (custom, lookalike, saved) and pagination. - `adside meta behaviors search` — List all available targetable behaviors from Meta's targeting categories. Returns behavior IDs, names, descriptions, and audience sizes. - `adside meta campaign-readiness check` — Check if a campaign is ready for ad set creation. Identify the campaign by ID or by name. Returns a readiness report with issues,... - `adside meta campaigns get` — Retrieve full details for a specific campaign by ID or name. Returns all campaign fields including status, objective, budget, and timing. - `adside meta campaigns list` — Retrieve a paginated list of all campaigns for a Meta ad account. Filter by status (e.g., ACTIVE, PAUSED) and view key campaign details... - `adside meta creative-best-practices get` — Get comprehensive best practices for creating high-performing ad creatives. Includes platform-specific guidelines, content... - `adside meta creative-enhanced validate` — Enhanced creative validation with comprehensive checks including page permissions, image accessibility, and Meta API compliance.... - `adside meta creative-issues troubleshoot` — Diagnose and fix common creative creation and performance issues. Provide an error message or describe your issue to get specific... - `adside meta creative-performance get` — Get guidance on analyzing creative performance metrics. Provides recommended approaches for tracking creative effectiveness and... - `adside meta creative-setup validate` — Validate ad creative parameters before creation to catch errors early. Checks required fields, URL validity, and provides... - `adside meta creatives list` — Browse an ad account's creatives, one page at a time. Each row is a SUMMARY — id, name, headline, primary text, call to action,... - `adside meta custom-conversions list` — List the account's custom conversions — the named conversions built on a dataset's traffic, as opposed to Meta's standard pixel events... - `adside meta demographics search` — List all available targetable demographics from Meta's targeting categories. Returns demographic IDs, names, descriptions, and audience... - `adside meta error-codes get` — Get detailed reference for Meta Marketing API error codes, subcodes, and specific solutions. Essential for troubleshooting Marketing API... - `adside meta geo-locations search` — Search for targetable geographic locations (countries, regions, cities, zip codes) by keyword. Returns location keys for use in ad set... - `adside meta insights export` — Export performance insights data in CSV or JSON format. Fetches up to 1000 records for comprehensive data export with optional breakdowns. - `adside meta insights get` — LIVE performance insights straight from the Meta Graph API (impressions, clicks, spend, CTR, CPC, actions, conversions) for a campaign,... - `adside meta interest-suggestions get` — Get suggested interests similar to a list of seed interests. Useful for expanding targeting reach based on existing high-performing... - `adside meta interests search` — Search for targetable interests by keyword. Returns interest IDs, names, audience sizes, and topic paths for use in ad set targeting. - `adside meta performance compare` — Compare performance metrics across multiple campaigns, ad sets, or ads side by side. Returns ranked comparisons with summary statistics... - `adside meta pixel-stats get` — Read recent event activity directly from Meta's pixel/dataset stats edge, even when no ad sets use it. Default event_total_counts lists... - `adside meta pixels get` — Read a pixel/dataset's activity metadata and optional matching/settings/dataset counters. Uses a pixel_id from get_account_pixels,... - `adside meta quick-fixes get` — Get targeted troubleshooting tips for common Meta Ads API errors. Provide an error message to receive likely causes, suggestions, and... - `adside meta video-preferred-thumbnail get` — Wait for Meta to finish processing an uploaded video and return its preferred thumbnail URL. Use after upload_video_from_url before... ### adside reddit - `adside reddit account-history get` — The change log of the connected ad account: who changed what (budgets, bids, statuses, targeting, creation) and when. Member emails and... - `adside reddit account-overview get` — Where the account stands: campaign / ad group / ad counts by status, spend and clicks for the last 7 days versus the 7 before, and the... - `adside reddit ad-accounts get` — The Reddit ad account this client is connected to: currency, time zone, attribution windows, approval state, funding instruments (and... - `adside reddit ad-groups get` — One Reddit ad group by id: status, budget, bid strategy, optimization goal, pixel, schedule and full targeting. - `adside reddit ad-groups list` — List ad groups on the connected account (optionally one campaign's) with status, budget, bid and a one-line targeting summary. Reddit... - `adside reddit ads get` — One Reddit ad by id with its creative (the post behind it): headline, media, destination, click URL and tracking parameters,... - `adside reddit ads list` — List ads on the connected account, optionally within one campaign or ad group, with status, creative type and headline. Filters on... - `adside reddit bids suggest` — Reddit's suggested bid range (min / median / max) for a bid type, objective and targeting, in the account currency. Costs 1 request. - `adside reddit campaign-readiness check` — Can this campaign deliver? Checks funding, pixel, ad groups, ads, approval and delivery states and returns is_ready plus the issues, the... - `adside reddit campaigns get` — One Reddit campaign by id: status, delivery status, objective, budget, funding instrument, pixel, dates. - `adside reddit campaigns list` — List campaigns on the connected Reddit ad account with status, objective and budget. Archived and deleted campaigns are hidden unless... - `adside reddit channel-status get` — Self-diagnosis of the Reddit connection: who the token belongs to, the connected ad account and business, rate-limit state observed in... - `adside reddit communities search` — Find subreddits to target: search by name, get suggestions similar to seed communities, or suggestions for a website. Returns names (use... - `adside reddit creative-assets list` — The asset library (images, videos, headlines, CTAs) of the account's profiles — the inputs Reddit Max campaigns assemble ads from. - `adside reddit creatives analyze` — Creative performance: every ad's spend, impressions, clicks, CTR and conversions joined with its creative type and headline, plus a... - `adside reddit custom-audiences get` — One custom audience by id, with the ad groups on this account that target or exclude it. - `adside reddit custom-audiences list` — Custom audiences on the connected account (customer lists, pixel and engagement retargeting) with type, status and size range. - `adside reddit daily-performance get` — Core metrics by day for the account, a campaign, an ad group or an ad, with day-over-day change in spend. Costs 1 request. - `adside reddit delivery diagnose` — Why isn't it delivering? For each campaign: effective and delivery status translated to a cause and next action, ad groups without ads,... - `adside reddit entity find` — Find campaigns, ad groups or ads by name on the connected account (case-insensitive substring). Use it to turn a name from the user into... - `adside reddit funding-instruments list` — Funding instruments (payment methods / credit lines) on the connected ad account, with whether each can serve and why not. A campaign... - `adside reddit geolocations search` — Resolve geolocation ids for targeting: countries, regions, cities, DMAs and postal codes. Give a country to list its regions, add... - `adside reddit interests list` — Every interest category Reddit offers for targeting, grouped, with the ids to put in targeting.interests. - `adside reddit keywords suggest` — Keyword suggestions (with monthly views on Reddit) from seed terms, or validation of the seeds themselves. - `adside reddit pacing analyze` — Is spend on track? For each active ad group (and CBO campaign): budget type and amount, spend in the window, daily average, pace index... - `adside reddit performance compare` — Side-by-side comparison: either this window versus the previous period at a level, or several objects (campaigns, ad groups or ads) in... - `adside reddit performance rank` — Rank a dimension (campaigns, ad groups, ads, communities, keywords, interests, placements, countries, …) by one metric over a window,... - `adside reddit pixel-events list` — When each standard and custom event last fired on the connected account's pixel(s), with age. Use it to confirm a pixel install or a... - `adside reddit pixels list` — Reddit pixels on the connected ad account with when each standard and custom event last fired. Every ad account gets a default pixel... - `adside reddit post-job get` — Status of a structured-post creation job (QUEUED → PROCESSING → SUCCESS | CLIENT_ERROR | SERVER_ERROR) and the post id once it exists. - `adside reddit posts get` — One post (ad creative) by id: headline, type, media URLs, destination and call-to-action, comment setting, public URL. Falls back to the... - `adside reddit posts list` — Posts (ad creatives) on the connected account's profiles — headline, type, destination, media — or the posts behind specific ads. A... - `adside reddit profiles list` — Reddit profiles shared with the connected ad account. Posts (ad creatives) are authored from a profile, so create_reddit_post and... - `adside reddit reach estimate` — How many people a targeting can reach: Reddit's channel-planning reach curve for a geolocation (7 or 28 days) and, when a targeting... - `adside reddit report get` — Performance report for the connected Reddit ad account: any level (account, campaign, ad group, ad), friendly metric names or metric... - `adside reddit report-fields list` — The report vocabulary get_reddit_report accepts: metric groups, every metric with its unit (money, count, rate) and every breakdown.... - `adside reddit saved-audiences get` — One saved audience by id with its full targeting. - `adside reddit saved-audiences list` — Reusable targeting definitions (saved audiences) on the connected account. - `adside reddit targeting-options list` — Static targeting vocabularies: devices, carriers, languages, time zones, industries. - `adside reddit third-party-audiences list` — Third-party (data partner) audiences available for targeting on Reddit, with provider and size where given. Reference them from... - `adside reddit third-party-trackers list` — The click and impression tracker domains Reddit accepts on an ad's event_trackers (DoubleVerify, IAS, MOAT, …). Check before attaching a... - `adside reddit tracking-health check` — Are conversions being tracked? Every pixel on the account with the age of its last fire per standard and custom event (healthy < 24 h,... ### adside reporting - `adside reporting budgets` — Refresh and read current campaign budgets - `adside reporting conversion-mapping get` — Read the primary conversion mapping and optional suggested events - `adside reporting conversion-options` — List native conversion events and custom actions with workspace activity - `adside reporting conversions` — Query mapped conversion performance across channels - `adside reporting creative-filters` — List creative intelligence filters for a reporting source - `adside reporting creatives analysis` — Read the existing creative AI analysis without requesting a new one - `adside reporting creatives comments` — Read comments on a creative across its ad variants - `adside reporting creatives download` — Download a creative video (up to 256 MiB) - `adside reporting creatives get` — Read performance and breakdowns for a creative - `adside reporting creatives rank` — Get top creatives - `adside reporting creatives transcript` — Request a video's timestamped transcript or return its existing result - `adside reporting creatives transcript-status` — Read a video's transcript status and result without starting transcription - `adside reporting performance query` — Query ad performance - `adside reporting reports create` — Save a dashboard report - `adside reporting reports delete` — Delete a saved report - `adside reporting reports get` — Read a saved report definition - `adside reporting reports list` — List saved reports - `adside reporting reports update` — Update report metadata or its view definition - `adside reporting spend` — Query cross-channel spend and mapped conversions - `adside reporting sync start` — Request a manual reporting sync subject to cooldown and current connection state - `adside reporting sync status` — Read reporting sync progress, freshness and caller-specific availability - `adside reporting themes get` — Read a messaging theme and its paginated creatives - `adside reporting themes list` — Compare performance by messaging theme ### adside research - `adside research ad-library search` — Search cached brand ads or explicitly request a paid scrape - `adside research ads analysis` — Read an existing creative analysis for a tracked company's ad - `adside research ads brands` — Search public brands by name - `adside research ads company` — Read all cached ad sources, insights and pending runs for a tracked company - `adside research ads fetch` — Read cached public ads or start an asynchronous brand scrape - `adside research ads run` — Read the status and results of a public ad-library scrape - `adside research ads suggestions` — Find Meta Ad Library pages for a brand - `adside research ads transcript` — Read an existing transcript for a tracked company's video ad - `adside research collections add` — Add a tracked company to a collection - `adside research collections create` — Create a company collection - `adside research collections delete` — Delete a custom company collection - `adside research collections get` — Read a company collection and its members - `adside research collections list` — List company collections - `adside research collections remove` — Remove a company from a collection - `adside research collections update` — Update a company collection - `adside research companies ads get` — Read a tracked company's ad for its detail view - `adside research companies delete` — Archive a tracked company, or permanently remove it - `adside research companies get` — Read a tracked company - `adside research companies list` — List tracked companies and their current extraction state - `adside research companies refresh-ads` — Refresh tracked-company ads, with explicit force for an already populated library - `adside research companies refresh-profile` — Refresh a competitor profile subject to the shared cooldown - `adside research companies track` — Track or reactivate a company and request its research - `adside research companies update` — Update a tracked company's workspace metadata - `adside research discover` — Discover competitors for the workspace's company - `adside research feed` — Query and filter the workspace's cross-competitor ad feed - `adside research inspiration get` — Read one inspiration item in this workspace's feed - `adside research inspiration list` — Read the workspace inspiration feed - `adside research inspiration refresh` — Refresh the workspace inspiration feed - `adside research inspiration run` — Read inspiration refresh status ### adside routines - `adside routines create` — Approve and create a scheduled routine; returns it with `task.url`, its page in Adside. - `adside routines delete` — Delete a scheduled routine - `adside routines get` — Read a routine and its recent actions - `adside routines list` — List workspace routines - `adside routines run` — Trigger an immediate authorized routine run - `adside routines runs` — Read recent routine runs - `adside routines templates` — List active routine templates and their suggested skills - `adside routines update` — Approve routine edits and reauthorize its future runs ### adside skills - `adside skills create` — Create a skill in the organization library - `adside skills delete` — Delete a skill - `adside skills generate` — Draft skill instructions from a description - `adside skills get` — Read a skill - `adside skills get-by-slug` — Read a skill by its stable slug - `adside skills list` — List organization skills - `adside skills templates` — List active skill templates available to this organization - `adside skills update` — Edit a skill ### adside snapchat - `adside snapchat ad-accounts get` — Get the Snapchat ad account this client is connected to — name, status, currency, timezone, and your role on it. There is no 'list ad... - `adside snapchat ad-squad get` — Get a single Snapchat ad squad by id. - `adside snapchat ad-squads list` — List Snapchat ad squads for this client's ad account, optionally filtered by campaign or status. - `adside snapchat ads get` — Get a single Snapchat ad by id. - `adside snapchat ads list` — List Snapchat ads for this client's ad account, optionally filtered by ad squad or status. - `adside snapchat campaigns get` — Get a single Snapchat campaign by id. - `adside snapchat campaigns list` — List Snapchat ad campaigns for this client's ad account, optionally filtered by status. - `adside snapchat creative-preview get` — Get a 90-day signed preview link for a Snapchat creative — no login required. Use this to show what the ad looks like. - `adside snapchat creatives get` — Get a single Snapchat creative by id, including its derived destination URL (web_view_properties.url,... - `adside snapchat creatives list` — List Snapchat creatives for this client's ad account, optionally filtered by type or review status. Each creative's destination URL... - `adside snapchat media list` — List media (uploaded images/videos) on this client's ad account. - `adside snapchat pixels list` — List the Snap Pixels configured on this client's ad account — use the pixel id as `pixel_id` targeting on ad squads, or to look up... - `adside snapchat stats get` — Get Snapchat delivery/reach/conversion stats for an ad account, campaign, ad squad, or ad. `spend` and every `*_value` conversion metric... ### adside tiktok - `adside tiktok action-categories get` — List TikTok behavior/action categories for targeting (user actions on TikTok) - `adside tiktok ad-groups list` — List TikTok ad groups with optional filtering - `adside tiktok ads list` — List TikTok ads with optional filtering by ad group, campaign, or status - `adside tiktok advertiser-info get` — Get TikTok advertiser account details (name, status, currency, timezone, balance) - `adside tiktok advertisers list` — List the TikTok advertiser account this client is connected to. Always returns that one account — other advertisers the credentials can... - `adside tiktok audience-report get` — Get TikTok audience demographic breakdown (age, gender, country, OS, language) - `adside tiktok campaigns list` — List TikTok ad campaigns with optional filtering by name, objective, status. Returns paginated results. - `adside tiktok identities get` — List available TikTok identities for ad creation. An identity is required as the ad author. - `adside tiktok image-info get` — Get TikTok image details (dimensions, format, URL) - `adside tiktok interest-categories get` — List all TikTok interest category tree for browsing (not keyword search). Returns hierarchical categories with IDs. - `adside tiktok interest-categories search` — Search TikTok interest categories by keyword for targeting. Returns interest IDs to use in ad group targeting. - `adside tiktok locations search` — Search TikTok targeting locations by keyword. Returns location IDs for use in ad group targeting. - `adside tiktok report get` — Get TikTok integrated reporting with dimensions, metrics, date range, and filters. Supports campaign/ad group/ad level. - `adside tiktok video-info get` — Get TikTok video processing status and details (duration, dimensions, format) ### adside todos - `adside todos assignees` — List eligible task assignees - `adside todos create` — Create a task - `adside todos delete` — Delete a task - `adside todos get` — Read a task - `adside todos list` — List tasks with assignee, status and due-date filters - `adside todos mine` — List tasks assigned to the caller across their accessible workspaces - `adside todos update` — Edit a task or its status and assignee ### adside workspace - `adside workspace connections` — Read client-safe connection summaries without provider credentials ### adside x - `adside x account-history get` — The change log of one object on the connected account (X requires an entity_type and entity_id): who changed which field, old → new... - `adside x account-overview get` — Where the account stands: campaign / line item / promoted post counts by status and servability, spend, impressions and clicks for the... - `adside x account-posts list` — Posts available to the connected account as ad creatives: nullcast (promoted-only) posts by default, or the handle's organic timeline,... - `adside x active-entities get` — Which entities had any activity (impressions, spend) in a window of up to 90 days, with their activity window and the placements they... - `adside x ad-accounts get` — The X ads account this client is connected to: approval state, time zone, currency, what the connected user's token may do on it... - `adside x audiences estimate` — How many X users a set of targeting criteria reaches (min–max), for a line item you are about to build or change. Read-like: nothing is... - `adside x bidding-rules list` — X's minimum / maximum bid per objective for a currency (from GET bidding_rules, a global read cached for an hour), plus the objective ×... - `adside x campaign-reach get` — Total audience reach and average frequency for up to 20 campaigns over a window. Costs 1 request. - `adside x campaign-readiness check` — Can this campaign deliver? Checks the funding instrument, line items (future window, non-empty targeting, bid, objective requirements... - `adside x campaigns get` — One X campaign by id: status and why it is or is not servable, funding instrument, budgets, and a summary of its line items (objective,... - `adside x campaigns list` — List campaigns on the connected X ads account with status, servability (reasons_not_servable) and budgets. Deleted campaigns are hidden... - `adside x cards list` — Cards on the connected account (website / app / carousel cards a post references through card_uri): card type, components (media, title... - `adside x channel-status get` — Self-diagnosis of the X connection: the connected ads account and its approval, who the token belongs to and their permissions,... - `adside x custom-audiences get` — One custom audience with its size, targetability, type, and the campaigns / line items currently targeting it. Costs 2 requests. - `adside x custom-audiences list` — Custom audiences on the connected account (CRM lists, website / app / engagement audiences): size, whether targetable and why not (X... - `adside x daily-performance get` — Core metrics by day for the account, one campaign, one line item or one promoted post, with day-over-day change in spend (sync, ≤7 days;... - `adside x delivery diagnose` — Why isn't it delivering? For each campaign: every reasons_not_servable value on it and its line items translated to a cause and next... - `adside x entity find` — Find campaigns, line items or nullcast posts by name (or post text) on the connected account, case-insensitive substring. Use it to turn... - `adside x funding-instruments list` — Funding instruments (credit card, credit line, insertion order) on the connected X ads account: type, currency, credit limit /... - `adside x keyword-insights search` — Conversation volume on X for keywords over a window (daily or hourly), to size keyword targeting before committing budget. Costs 1 request. - `adside x line-items get` — One X line item by id: status and servability, objective, product type, placements, goal, bid strategy and amount, budgets, window,... - `adside x line-items list` — List line items (ad groups) on the connected account, optionally one campaign's, with status, servability, objective, bid, budgets and... - `adside x media-library list` — Images, GIFs and videos in the connected account's Media Library with media keys (what a post or card references), type, processing... - `adside x media-status get` — Processing state of one media item: the Media Library record (media_status, e.g. TRANSCODE_COMPLETED) and, for a video still processing,... - `adside x metrics list` — The analytics vocabulary get_x_stats accepts: metric groups and their exact metric names, friendly aliases (spend =... - `adside x pacing analyze` — Is spend on track? For each active line item (and its campaign): daily / total budget, spend in the window, daily average, pace index... - `adside x performance compare` — Side-by-side comparison: this window versus the previous period for the account (or one level's active entities), or several objects... - `adside x posts get` — One post by tweet id as the ads account sees it: text, nullcast flag, media keys and types, card, landing URL, conversation settings. - `adside x posts preview` — Accurate, up-to-date renderings of posts (published, scheduled or draft) as X shows them, as preview URLs (iframe sources on... - `adside x promotable-users list` — Users whose posts this ads account may promote: the FULL user (nullcast posts are authored as this user — its user_id is the as_user_id... - `adside x promoted-posts get` — One promoted post by id with its tweet (text, media, card, landing URL), approval status and a rendered preview URL. Costs 3 requests. - `adside x promoted-posts list` — Promoted posts (promoted tweets) on the connected account, optionally for one line item or campaign, each with entity status, X's... - `adside x stats get` — Synchronous performance stats for up to 20 entities over at most 7 days (X's caps): any entity level, friendly metric names or X metric... - `adside x stats-job create` — Start an asynchronous stats job for up to 20 entities over up to 90 days (45 if segmented), one placement, optional segmentation.... - `adside x stats-job get` — Status of up to 200 async stats jobs (PROCESSING / SUCCESS / FAILED) with what each covers and when a finished result expires. - `adside x stats-job-result fetch` — Download a finished stats job's result (gzip JSON on X's CDN) and render it like get_x_stats: table under the byte budget, summary,... - `adside x targeting suggest` — X's targeting suggestions from seed keywords (more keywords) or seed user ids (similar accounts for FOLLOWERS_OF_USER /... - `adside x targeting-criteria list` — Every targeting criterion on the given line items (type, value, name, include/exclude), one block per line item with the... - `adside x targeting-interests search` — Interest categories X offers for INTEREST targeting (id + name, nested by 'Parent - Child'), optionally filtered by a search term. Put... - `adside x targeting-locations search` — Resolve LOCATION targeting values (countries, regions, metros / DMAs, cities, postal codes) by name; the returned targeting_value is... - `adside x targeting-options list` — Static targeting vocabularies: devices, platforms, platform_versions, languages, network_operators, events, conversations, tv_shows,... - `adside x tracking-health check` — Is measurement wired up? Lists the account's web event tags (pixel events — if the endpoint answers), app event tags and third-party... - `adside x tracking-tags list` — Third-party impression / click tracking tags attached to line items on the connected account (type, URL, line item). Pixel events... ## Model catalog Every model is priced at the provider's own cost, no margin. Prices below are per generation (ranges span resolution and duration options). `adside media models` always lists what is live; `adside media recommend` picks for you. ### Image models (27) | Model | Best for | Price | |---|---|---| | `google/gemini-nano-banana-2.1` (default) | Default stills; Products composited from reference images | $0.05-$0.13 | | `sourceful/riverflow-v2.6-pro` | Riverflow 2.6 Pro is the flagship model of Sourceful's Riverflow 2.6 lineup, a unified text-to-image and... | $0.14-$0.18 | | `qwen/qwen-image-2.1-turbo` | Qwen Image 2.1 Turbo is the fast, lower-cost tier of the Qwen Image 2.1 series from Qwen, for image... | $0.02 | | `qwen/qwen-image-2.1-pro` | Qwen Image 2.1 Pro is an image generation and editing model from Qwen, the higher-quality tier of the Qwen... | $0.05 | | `black-forest-labs/flux-3-image-klein` | FLUX 3 Image Klein is an open-weights image generation and editing model from Black Forest Labs. | $0.01-$0.04 | | `bytedance-seed/seedream-5-0-flash` | Seedream 5.0 Flash is an image generation and editing model from ByteDance Seed. | $0.02 | | `black-forest-labs/flux-3-image` | FLUX.3 Image is Black Forest Labs' flagship image generation and editing model. | $0.05-$0.65 | | `recraft/recraft-v4.1-flash` | Recraft V4.1 Flash is a text-to-image model from Recraft, the speed and cost tier of the V4.1 family. | $0.01 | | `bytedance-seed/seedream-5-0-lite` | Seedream 5.0 Lite is an image generation model from ByteDance Seed. | $0.04 | | `x-ai/grok-imagine-image-2.0` | Grok Imagine Image 2.0 is an image generation and editing model from xAI. | $0.07-$0.09 | | `qwen/qwen-image-3-pro` | Qwen Image 3 Pro is an image generation and editing model from Qwen. | $0.05-$0.08 | | `qwen/qwen-image-3` | Qwen Image 3 is a unified image generation and editing model from Qwen. | $0.04 | | `krea/krea-2-large` | Krea 2 Large is Krea's high-capability image generation model, more than twice the size of Krea 2 Medium. | $0.07 | | `krea/krea-2-medium` | Krea 2 Medium is Krea's balanced, cost-efficient image generation model and a practical starting point for... | $0.04 | | `krea/krea-2-medium-turbo` | Krea 2 Medium Turbo is a distilled, speed-focused variant of Krea 2 Medium from Krea. | $0.02 | | `sourceful/riverflow-v2.5-pro` | Riverflow V2.5 Pro is the most powerful variant of Sourceful's Riverflow 2.5 lineup, best for top-tier... | $0.14-$0.18 | | `sourceful/riverflow-v2.5-fast` | Riverflow V2.5 Fast is the speed-optimized variant of Sourceful's Riverflow 2.5 lineup, best for... | $0.03 | | `recraft/recraft-v4.1-utility-pro` | Recraft V4.1 Utility Pro is a general-purpose image generation model from Recraft. | $0.23 | | `recraft/recraft-v4.1-utility` | Recraft V4.1 Utility is a general-purpose image generation model from Recraft. | $0.04 | | `recraft/recraft-v4.1-pro` | Recraft V4.1 Pro is an image generation model from Recraft tuned for high aesthetics. | $0.23 | | `recraft/recraft-v4.1` | Recraft V4.1 is an image generation model from Recraft tuned for high aesthetics. | $0.04 | | `recraft/recraft-v4-pro` | Recraft V4 Pro is an image generation model from Recraft. | $0.27 | | `recraft/recraft-v4` | Recraft V4 is an image generation model from Recraft. | $0.05 | | `recraft/recraft-v3` | Recraft V3 is an image generation model from Recraft. | $0.05 | | `sourceful/riverflow-v2-pro` | Riverflow V2 Pro is the most powerful variant of Sourceful's Riverflow 2.0 lineup, best for top-tier... | $0.16-$0.35 | | `sourceful/riverflow-v2-fast` | Riverflow V2 Fast is the fastest variant of Sourceful's Riverflow 2.0 lineup, best for production... | $0.03-$0.05 | | `bytedance-seed/seedream-4.5` | Seedream 4.5 is the latest in-house image generation model developed by ByteDance. | $0.05 | ### Video models (27) | Model | Best for | Price | |---|---|---| | `google/gemini-omni-1.1-flash` (default) | Default motion; Native music and sound effects | $0.41-$0.82 | | `tbc/mischief-1` | TBC mischief 1 is the world's first neuron-derived video model from The Biological Computing Co. | $0.02-$0.06 | | `x-ai/grok-imagine-video-1.5-lite` | Grok Imagine Video 1.5 Lite is a faster, lower-cost video generation model from SpaceXAI, distilled from... | $0.11-$0.74 | | `minimax/hailuo-3-max` | MiniMax H3 Max is a video-generation model from MiniMax, jointly released with fal.ai. | $0.27-$0.43 | | `alibaba/wan-3.0-prime` | Wan 3.0 Prime is a fast-mode variant of Wan 3.0 from Alibaba. | $0.36-$1.48 | | `alibaba/wan-3.0` | Wan 3.0 is a video generation model from Alibaba for text-to-video, image-to-video, and reference-guided... | $0.27-$1.06 | | `bytedance/seedance-2.0-mini` | Seedance 2.0 Mini is a video generation model from ByteDance. | $0.19-$0.41 | | `bytedance/seedance-2.5` | Seedance 2.5 is a video generation model from ByteDance. | $0.58-$1.23 | | `black-forest-labs/flux-3-video` | FLUX.3 Video is a video generation model from Black Forest Labs. | $0.90-$2.17 | | `minimax/hailuo-3` | MiniMax H3 is a lightweight, open-weights video generation model from MiniMax. | $0.69 | | `runway/gen-4.5` | Runway Gen-4.5 is a video generation model from Runway for text-to-video and image-to-video workflows. | $0.64 | | `x-ai/grok-imagine-video-1.5` | Grok Imagine Video 1.5 is a video generation model from SpaceXAI. | $0.43-$1.32 | | `alibaba/happyhorse-1.1` | HappyHorse 1.1 is a video generation model from Alibaba. | $0.53-$0.68 | | `alibaba/happyhorse-1.0` | HappyHorse 1.0 is a video generation model from Alibaba. | $0.53-$0.90 | | `x-ai/grok-imagine-video` | Grok Imagine Video is SpaceXAI's fast, text-, image-, and reference-conditioned video generation model. | $0.27-$0.37 | | `kwaivgi/kling-v3.0-pro` | Kling v3.0 Pro is Kuaishou's premium video generation model, offering higher visual quality than the... | $0.60-$0.89 | | `kwaivgi/kling-v3.0-std` | Kling v3.0 Standard is a video generation model from Kuaishou. | $0.45-$0.67 | | `google/veo-3.1-fast` | Google's mid-tier video generation model balancing speed and quality. | $0.34-$2.54 | | `google/veo-3.1-lite` | Google's most cost-effective video generation model, designed for high-volume applications and rapid... | $0.13-$0.68 | | `kwaivgi/kling-video-o1` | Kling Video O1 is a video generation model from Kuaishou. | $0.60-$1.19 | | `minimax/hailuo-2.3` | Hailuo 2.3 is a video generation model from MiniMax. | $0.52-$0.87 | | `bytedance/seedance-2.0-fast` | Seedance 2.0 Fast is a video generation model from ByteDance. | $0.23-$0.49 | | `alibaba/wan-2.7` | Wan 2.7 is a video generation model from Alibaba. | $0.53 | | `bytedance/seedance-2.0` | Seedance 2.0 is a video generation model from ByteDance. | $0.38-$2.00 | | `alibaba/wan-2.6` | Alibaba's most advanced video generation model, supporting over 10 visual creation capabilities in a... | $0.43-$1.27 | | `bytedance/seedance-1-5-pro` | ByteDance's next-generation audio-visual generation model with a 4.5B parameter Dual-Branch Diffusion... | $0.07-$0.63 | | `google/veo-3.1` | Google's state-of-the-art video generation model, built for maximum visual fidelity in final production cuts. | $0.85-$5.07 | ### Avatar models (3) | Model | Best for | Price | |---|---|---| | `bytedance/omnihuman-v2` (default) | A presenter or creator talking to camera (UGC-style ads); Realistic people | $0.10 | | `kwaivgi/kling-ai-avatar-v2-pro` | Mascots, cartoon and stylized characters; Animals that talk | $0.12 | | `kwaivgi/kling-ai-avatar-v2-standard` | Drafts of a performance before the final take; Cheap short lines for characters | $0.06 | ### Speech models (4) | Model | Best for | Price | |---|---|---| | `elevenlabs/eleven-v4` (default) | Default voice-overs; Ad reads and product explainers | $0.08 | | `elevenlabs/eleven-v4-turbo` | Drafts and timing checks; Long scripts where price matters more than nuance | $0.04 | | `elevenlabs/eleven-v3` | Emotional or theatrical reads; Characters and dialogue-style ads | $0.10 | | `elevenlabs/multilingual-v2` | Long narration (up to 10,000 characters); A set speaking speed | $0.10 | ### Music models (1) | Model | Best for | Price | |---|---|---| | `elevenlabs/music-v2.5` (default) | Background music for ads and product videos; Jingles and short stings | $0.60 | ### Sound effects models (1) | Model | Best for | Price | |---|---|---| | `elevenlabs/sound-effects-v2` (default) | Foley and transitions for ads; Ambient loops under a voice-over | $0.01 | ### Lipsync models (1) | Model | Best for | Price | |---|---|---| | `veed/lipsync-v2` (default) | A new or corrected line on a clip you already have; The same performance in another language | $0.07 | ## MCP The same account and permissions are available over MCP for chat clients: - URL: `https://api.adside.ai/mcp` - Claude Code: `claude mcp add --transport http adside https://api.adside.ai/mcp` - Codex: `codex mcp add adside --url https://api.adside.ai/mcp` - Claude, ChatGPT, Cursor and other MCP clients: add the URL as a connector and sign in. The CLI covers the whole product and works anywhere a shell runs; MCP is the door for chat apps. ## Permissions Every command runs with the signed-in person's Adside role. A read-only API key can read everything and change nothing. Launching or changing campaigns waits for human approval in Adside. Ad platform logins (Meta, Google, ...) stay inside Adside and never sit in a config file or key. ## Pricing $290 per brand, per month, or $190 per month with annual prepay. Everything is included: the CLI, the MCP, research, creative, reporting and operations, for unlimited users and agents, with $100 of creative credits every month (credits are billed at provider cost, no margin). 7-day free trial. Each brand (or each client, for an agency) is its own workspace. The managed service ($3,500 per month, 10% of ad spend) adds a dedicated expert from our network who implements the agents for you. Start at https://www.adside.ai/get-started ## A sensible first session 1. `adside whoami` — confirm the login and workspace. 2. `adside workspace connections` — see which ad accounts are connected. If none, ask the human to connect them in Adside. 3. `adside reporting spend --period 7d` — the last week across channels. 4. `adside brain read` — what Adside already knows about this brand. 5. Tell the human what stands out and what you suggest doing next. ## Run ads from a chat agent One page per agent app, each with its setup prompt: [Muse](https://www.adside.ai/agents/muse) (Meta's assistant, one pasted message), [Grok Bot](https://www.adside.ai/agents/grok-bot) (runs this CLI on its own cloud computer), [Duet](https://www.adside.ai/agents/duet) (your ads in the morning brief) and [dots](https://www.adside.ai/agents/dots) (a weekly creative loop in ChatGPT). ## Links - This page for humans: https://www.adside.ai/agents - npm package: https://www.npmjs.com/package/adside - What $100 of creative credits buys (real ads at five budgets, every cost itemized): https://www.adside.ai/tools/ai-ads-cost - Pricing: https://www.adside.ai/pricing - Blog: https://www.adside.ai/blog