whoami
Describe the current API key
Report the name of the API key in use, the ADS Beast organization it belongs to, the scopes it carries and, in one line, whether it is read-only or can propose changes. The scope list is what a 403 from any other tool in this server refers to: a key without read:leads reaches no lead tool, whatever else it holds.
Takes no parameters.
get_new_leads
Pull leads, including newly created ones
A page of leads with contact details, form answers and attribution (UTM, click ids, platform form, lead and campaign ids). Pass updated_since (ISO-8601, your last sync) to get only new or changed leads. Reply: {count, leads, has_more, next_offset, offset, limit}; page with next_offset while has_more.
Parameterslimitsincestageoffsetsourceclient_idupdated_since
Return a single lead by its ADS Beast id with every field the record holds, including email, phone, qualification answers, attribution and its current pipeline stage.
Parameterslead_idrequired
list_lead_forms
List known lead forms
Return the lead forms recorded for this organization, which maps the form ids and source keys that appear on a lead to readable form names.
Parameterslimitoffsetplatformclient_id
lead_pipeline_stats
Summarise the lead pipeline
Return aggregate lead counts by pipeline stage over a recent window, for the whole organization or for one client.
Parametersdaysclient_id
lead_outcome_contract
Get the accepted outcome fields
Return the field names and outcome values that push_lead_outcomes accepts, as the server currently defines them.
Takes no parameters.
Change fields on one existing lead: notes, assignee, contact details or pipeline stage. Only the keys supplied are written; the rest of the record is left as it is. A key that is not writable is refused with the list of fields that are, so a misspelled field cannot pass as a successful write.
Parametersfieldsrequiredlead_idrequired
move_lead_stage
Move a lead to another stage
Move one lead to a different pipeline stage. Unlike setting the stage through update_lead, this also remaps the lead's close probability to the value configured for the new stage.
Parametersstagerequiredlead_idrequired
push_lead_outcomes
Push CRM outcomes back into the pipeline
Write the real outcome of leads back into ADS Beast so the ad platforms learn which leads became sales. Each row names a lead by lead_id, email or phone, and its outcome. dry_run defaults to true and reports what would change without writing; run it first. Unmatched rows are skipped unless create_missing is true. The lead's stage follows the outcome unless update_stage is false.
Parametersrowsrequireddry_runclient_idupdate_stagesource_systemcreate_missing
list_campaigns
List campaigns
Return campaigns from every connected advertising platform in one list, with their status, budget and platform ids. Archived campaigns are left out unless include_archived is true.
Parameterslimitoffsetplatformclient_idinclude_archived
get_campaign
Get one campaign
Return a single campaign by its ADS Beast id with its settings, budget, status and the native id it has on its platform.
Parameterscampaign_idrequired
campaign_dashboard_summary
Summarise spend and delivery
Return spend, conversions and delivery health aggregated across the whole organization. The endpoint takes no filter and always covers every client; per-client figures come from list_campaigns with a client_id.
Takes no parameters.
Return the clients of this organization with their budgets, status and connected advertising accounts. A long list comes back as a page {result, total, has_more, next_offset}.
Parameterslimitoffset
Return a single client by its ADS Beast id: profile, budget, goals and connected advertising accounts.
Parametersclient_idrequired
list_reports
List generated reports
Return the client reports already generated in ADS Beast, newest first, with their type, period and client.
Parameterslimitoffsetclient_idreport_type
list_alerts
List monitoring alerts
Return the performance and delivery alerts raised by the ADS Beast monitoring agents, with their severity, the client or campaign they concern and whether they have been read or resolved.
Parameterslimitoffsetis_readseverityclient_idalert_typecampaign_idis_resolved
alerts_unread_count
Count unread alerts
Return how many live alerts are still unread, as a single number. An alert whose condition has already cleared is not counted even if nobody opened it, so this is the number that still needs a person. Cheaper than list_alerts when only the count matters.
Takes no parameters.
list_tasks
List team tasks
Return the team tasks recorded in ADS Beast with their status, priority, assignee and the client they belong to.
Parameterslimitoffsetstatuspriorityclient_idassigned_to
list_outreach_campaigns
List email outreach campaigns
Return a page of the email outreach campaigns, newest first, with their status, sender, offer pack, legal basis and daily limit. The reply is {campaigns, total, count, limit, offset, has_more, next_offset}; walk the pages with offset = next_offset. The letter itself is summarised as body_preview and body_chars; pass include_body = true for the full text.
Parameterslimitoffsetclient_idinclude_body
outreach_campaign_check
Check an email campaign before launch
Run the pre-launch check of one email outreach campaign: who may be emailed under its legal basis, why the others are blocked (consent, personal mailbox, country, unsubscribed), and sender problems. Blocker issues stop the campaign from being activated.
Parameterscampaign_idrequired
list_offer_packs
List offer packs
Return the offer packs outreach copy is built from: built-in samples and this organization's own client packs, with brand, languages, niches, the facts the copy relies on and how many errors or warnings the last check found.
Parameterslimitoffset
list_social_campaigns
List social prospecting campaigns
Return the Instagram/TikTok/Facebook prospecting campaigns: offer, platforms, cities with message language, daily manual-send cap.
Parameterslimitoffsetclient_id
get_social_queue
Get the social outreach queue
Return the next business profiles to message by hand, best first, within today's remaining cap per platform: profile link, signals (books by DM, by phone, competitor tool), the drafted first message in the profile's language (no link) and the follow-up with a tracked link to send after a reply. Nothing is sent by this tool.
Parameterslimitplatformcampaign_idrequired
update_social_prospect
Record what happened with a social prospect
Record the outcome of a hand-sent message: sent, replied, registered, declined, do_not_contact, skipped (or new to undo a mis-click), plus an optional note. Moves follow the pipeline (sent -> replied -> registered); 'sent' is refused once today's per-platform cap is used. This records a fact, it does not message anyone.
Parametersnotestatusprospect_idrequired
list_webhook_events
List subscribable events
Return the event names an outbound webhook can subscribe to, for example lead.created, with what each one carries.
Takes no parameters.
list_webhooks
List registered webhooks
Return the outbound webhook endpoints registered for this organization, the events each one receives and its current delivery state.
Parameterslimitoffset
create_webhook
Register an outbound webhook
Register an endpoint ADS Beast calls when a chosen event happens. From then on those records go to that URL until it is removed. Without client_id it covers every client of the organization. Deliveries carry an HMAC in X-ADS-Beast-Signature and are retried; the generated secret is not returned, so pass secret_key if the receiver verifies signatures.
Parametersurlrequirednamerequiredeventsrequiredclient_idsecret_key
seo_publish_safety
Check whether a site may publish now
Ask this before publishing or scheduling any article for a site. Returns its gradual-launch state: articles allowed today and already published, whether publishing is paused and why, and indexed versus kept-out articles. Rules: 2 new articles a day at start, plus 1 a week up to 6; one language version of a topic a day; search visits below 30% of the weekly median pause publishing until a person lifts it; articles under 600 words, without a meta description or reusing another language's address get noindex and stay out of the sitemap. Do not plan around these limits: mass near-identical pages is how sites lose Google traffic overnight.
Parametersclient_id
list_proposals
List change proposals
Change proposals waiting for a person (status pending by default), or their history. Each proposal shows what would change, why, and who proposed it.
Parameterslimitoffsetstatusclient_id
propose_campaign_change
Propose a campaign change (pause, enable, budget)
Create a change proposal for a campaign. Nothing changes in the ad account until a person approves the proposal in ADS Beast or in Telegram; the proposal expires on its own if nobody decides. State the reason with the numbers behind it.
Parameterschangerequiredreasonrequiredclient_idnew_budgetcampaign_idrequired
reject_proposal
Reject a change proposal
Reject a pending proposal with a short reason. Returns the proposal id and its new status.
Parametersreasonproposal_idrequired
list_campaign_types
Campaign types that can be drafted
Campaign types of the ADS Beast registry that an assistant may draft, per platform (google, meta, tiktok, linkedin, microsoft): the key to pass as campaign_type, the objective, required tracking, bid strategies and, under 'fields', exactly what a draft of that type needs with the platform's character limits. structure_check 'full' (Google Search, Meta) means the draft is validated the way the builder validates before publishing; 'basic' means only the common checks run. Call it with a platform before create_campaign_draft.
Parametersplatform
list_campaign_drafts
List campaign builds and drafts
Builds in the campaign builder, newest first, as summaries: name, platform, type, status (draft, ready, paused, launched), budget, how many ad groups, ads and keywords, whether an assistant created it, whether it was already published, and the cabinet link. A key bound to one client lists only that client's builds.
Parameterslimitoffsetstatusclient_id
get_campaign_draft
One campaign draft with its validation
The current content of one build and a fresh validation: 'problems' block publishing, 'warnings' do not, 'launch_blockers' say why a person could not publish right now (no connected account, writing switched off), 'not_checked_here' lists what only the publish step checks. Problem texts come from the builder's own checker and are in Russian; relay them in the user's language.
Parametersdraft_idrequired
create_campaign_draft
Create a campaign draft in the builder
Create a campaign as a DRAFT in the ADS Beast builder: type, geo, languages, daily budget, ad groups with keywords or audiences, ad texts, landing page. Nothing reaches the ad platform. Returns the draft id, builder_url and what still blocks publishing (platform limits, ad policy, compliance); a draft with problems is still saved for update_campaign_draft. Publishing: prepare_campaign_draft_publish or a person in the builder, always paused. Call list_campaign_types first.
Parametersgeonamerequiredextranotesaudienceplatformrequiredad_groupsclient_idrequiredlanguagesconversiontarget_cpalanding_url+5 more
update_campaign_draft
Change a campaign draft the assistant created
Replace fields of a draft that was created with create_campaign_draft and has not been published: each field passed replaces the stored one whole (ad_groups replaces all ad groups). Returns the draft with a fresh validation. Drafts made by a person in the builder and builds that were already published are refused. Nothing is sent to the ad platform.
Parametersgeonameextranotesaudiencedraft_idrequiredad_groupslanguagesconversiontarget_cpalanding_urltarget_roas+3 more
get_agency_kit
Agency Kit: everything about one client in one document
The knowledge pack the agency keeps for one client: who they are, accounts and campaigns with the last 30 days of results, leads by stage, KPI goals, the write policy, the methodology of working through ADS Beast and ready prompts. Read it first when a conversation is about one client. Contains no contacts or keys.
Parametersclient_idrequired
client_overview
Client overview
One client with its campaigns, key metrics and goals.
Parametersclient_idrequired
client_action_plan
Client action plan
The action plan from the client's latest weekly deep-dive audit: findings labelled confirmed, inferred or hypothesis, open change proposals and open tasks.
Parametersclient_idrequired
client_goals
Client KPI goals
KPI goals (ROAS, CPA, CTR, CPC) with target, current value, progress and status. Without client_id: goals of every client.
Parametersclient_id
client_data_freshness
Data freshness
When each client and platform was last synced. Call it before a deep analysis so stale data is named as stale.
Parametersclient_id
client_memory_search
Search client memory
Search the facts, decisions, preferences and brand notes ADS Beast has stored about clients.
Parametersqueryrequiredclient_id
client_history_search
Search past reports and audits
Full-text search over a client's earlier reports, audits and analyses.
Parameterslimitqueryrequiredclient_idreport_type
client_landing_scan
Scan a client's landing page
Read a landing page and extract its headline, offer, selling points, calls to action, keywords and tone. Without url, the client's own site is used. AI: 1 AI request.
Parametersurlclient_id
client_market_analysis
Get market analysis
The stored market analysis of a client: summary, competitor matrix, audience signals and the draft campaign strategy.
Parameterssectionclient_idrequired
client_market_analysis_run
Run market analysis
Crawl the client's site, find and analyse competitors and build a market intelligence report. Takes minutes; read the result with client_market_analysis. AI: 1 AI request.
Parametersforceclient_idrequired
client_market_intel_search
Search market intelligence
Semantic search over a client's indexed market data: its site, competitor profiles and the market report.
Parametersqueryrequiredtop_kclient_idrequired
client_market_simulation
Get market simulation
Status and report of the multi-agent market simulations requested for a client.
Parametersclient_idrequired
analytics_summary
Performance summary
Spend, CTR, CPA and ROAS of one client over a period. Money is reported in the account currency and never summed across currencies.
Parametersdaysplatformclient_idrequired
analytics_compare_periods
Compare two periods
Percentage change of every KPI between the current period and the one before it, by platform, with what got worse and what improved.
Parametersplatformclient_idrequiredcurrent_daysprevious_days
analytics_forecast
Forecast KPIs
Projection of CPA, ROAS and spend 7 and 30 days ahead from the current trend. A projection, not a promise: it extrapolates the last 14-30 days.
Parametersclient_idrequiredcampaign_id
analytics_forecast_warnings
Forecast warnings
Campaigns expected to break a KPI target within days, from a linear trend.
Parametersclient_idrequired
analytics_attribution
Attribution breakdown
Time-decay multi-touch attribution for a client's campaigns: attributed conversions, attributed CPA and the lift against last click.
Parametersdaysclient_idrequired
analytics_portfolio
Portfolio analysis
Cross-client analysis of the whole portfolio: best and worst performers, platform trends, total spend. Takes up to a minute. AI: 1 AI request.
Parametersdaysplatform
analytics_cross_client_insights
Cross-client insights
Patterns and anomalies across clients: platforms that sag for most of them, shared niche problems, who outperforms.
Parametersdaysplatform
analytics_kpi_health
KPI health check
Quick status of all active campaigns: how many are on target and how many need attention.
Parametersclient_id
analytics_growth_opportunities
Growth opportunities
Campaigns ready to scale: ROAS well above target, CPA well below target, or budget left unused.
Parametersclient_idmin_roas_multiplier
analytics_benchmarks
Industry benchmarks
Reference CTR, CPC, CPA and ROAS ranges for a platform and niche. Benchmarks are orientation, not a verdict on one account.
Parametersnicheplatformrequired
analytics_agency_briefing
Daily briefing
Morning briefing for the workspace: critical alerts, today's tasks and what needs attention now.
Takes no parameters.
analytics_media_plan
Media plan numbers
A sourced chain of planning numbers for a campaign type: CPM, reach, clicks, CPC, conversion rate, conversions, CPA, break-even and three scenarios. Every figure is labelled with where it comes from.
Parametersnichecurrencyplatformrequiredclient_idnum_objectsmonthly_budgetrequiredavg_order_valuegross_margin_pctobjective_or_typerequired
analytics_ab_tests
List A/B tests
A/B tests with their status and interim results.
Parameterslimitstatusclient_idcampaign_id
audit_account
Audit an ad account
AI audit of a client's ad account on one platform or all of them. Takes 10-30 seconds. AI: 1 AI request.
Parametersplatformclient_idrequired
audit_google_ads
Audit Google Ads
Full Google Ads audit for a client: structure, keywords, responsive search ads, extensions, bidding, conversions and Quality Score problems, with a 0-100 score and recommendations. AI: 1 AI request.
Parametersdepthclient_idrequired
audit_meta_ads
Audit Meta Ads
Full Meta Ads audit for a client: funnel structure, audiences, creatives, pixel health, conversion events, audience fatigue and Advantage+ setup. AI: 1 AI request.
Parametersclient_idrequired
audit_conversion_goals
Audit conversion goals
Check that a client's ads learn from real leads: which Google Ads conversions are primary, whether calls and forms are counted, and campaigns optimising for the wrong goal.
Parametersclient_idrequired
audit_tracking
Audit tracking setup
Tracking diagnostics for a client: pixel, GA4 and GTM mismatches on the landing page, conversion actions and the other tracking guards in one report.
Parametersclient_idrequired
audit_campaign_quality
Live campaign quality check
Reads every running Google and Meta campaign of a client from the platform and checks geo, conversions against the bid strategy, moderation, landing pages and search assets.
Parametersclient_idrequired
audit_wasted_spend
Find wasted spend
Campaigns that burn budget: spend with zero conversions, CPA above target, no clicks. Returns the amounts lost, in the account currency.
Parametersdaysclient_id
audit_campaign_portfolio
Scan campaign portfolio
Health score of every campaign, the ones in a critical state, without conversions, without goals or with stale data. A good first call before a deeper audit.
Parametersclient_idonly_active
audit_campaign_health
Campaign health summary
A 1-10 health score for each campaign of a client with the problems behind it.
Parametersclient_idrequired
audit_performance_coach
Performance coaching review
A prioritised optimisation plan for a client's last 7 days from four specialist reviews (media buying, budget, audience, creative), with a confidence level per item. Recommendations only. Takes up to a minute. AI: 1 AI request.
Parametersclient_idrequired
audit_ad_disapprovals
List disapproved ads
Ads the platforms rejected, with the reason and the policy code.
Parametersstatusplatformclient_id
recommendation_list
List open recommendations
Open recommendation cards: agent advice and Meta's own cabinet advice, judged against the client's goal.
Parameterslimitsourceplatformclient_id
campaign_search
Search campaigns by name
Campaigns filtered by client, platform, status or a substring of the name.
Parameterslimitstatusplatformclient_idname_filter
campaign_analyze
Analyse a campaign
Deep analysis of one campaign: metrics, trends and recommendations. Takes up to a minute. AI: 1 AI request.
Parametersdayscampaign_idrequired
campaign_diagnose
Diagnose a campaign problem
Works through the possible causes of one KPI problem in a campaign: audience saturation, creative fatigue, landing page, bid strategy, seasonality, tracking.
Parametersdaysproblemrequiredcampaign_idrequired
campaign_history_analysis
Analyse campaign history
What worked for a client before: average CPA and CTR, best campaigns and best audiences.
Parametersclient_idrequired
campaign_type_coverage
Campaign type coverage
Which campaign types ADS Beast supports on each platform and how far: creation through the API, generation, validation.
Parametersplatform
campaign_strategy_generate
Generate a strategy
A strategic plan for a client over a horizon: channels, budget split, KPI targets and launch phases. Takes up to a minute. AI: 1 AI request. May return a job_id (get_job_result).
Parametersfocusclient_idrequiredhorizon_months
campaign_strategy_expert_review
Expert strategy review
Six specialist viewpoints (media buyer, copywriter, audience, competitors, conversion, data) on a planned campaign. Takes up to a minute. AI: 1 AI request. May return a job_id (get_job_result).
Parametersgeoplatformclient_idrequiredobjectiveextra_contextbudget_monthly
campaign_swarm_runs
List campaign generation runs
Recent multi-agent campaign generation runs with status, platform and budget.
Parameterslimitclient_id
campaign_draft_details
Full campaign draft
A campaign draft in full: platform, type, goal, budget, UTM, targeting, ad groups with keywords and ads, and the platform campaign id once it was published.
Parametersbuild_idrequiredclient_idrequired
campaign_draft_publish_check
Rehearse publishing a draft
Validates a campaign draft against the live ad account and reports exactly what publishing would create or change. Read-only rehearsal: nothing is written.
Parametersbuild_idrequiredclient_idrequiredplatform_campaign_id
google_ads_ad_strength
Google ad strength
Ad Strength of a client's responsive search ads: counts by level and the weak ads with Google's own action items.
Parametersclient_idrequiredforce_refresh
google_ads_keyword_overlap
Find duplicate keywords
Finds the same keyword and match type enabled in two or more active Google campaigns of one account. Detection only.
Parametersclient_idrequired
google_ads_script_generate
Generate a Google Ads script
Returns a ready Google Ads Script (JavaScript) for one campaign that a person pastes into Google Ads themselves. The tool only produces text. Amounts are in the ad account's own currency, in whole units (not cents or micros).
Parametersactionrequirednew_valuecampaign_idrequired
google_ads_conversion_tracking_check
Check Google conversion tracking
Reads a client's Google Ads conversion actions and tag and reports which action fits the named conversion, or what would be created. Read-only.
Parametersnamerequiredcategoryclient_idrequiredaccount_id
google_ads_app_videos_check
Check videos for an App campaign
Reads a Google App campaign and validates the videos proposed for it. Read-only.
Parameterstitleclient_idrequiredaccount_idvideo_urlscampaign_idrequiredyoutube_videos
meta_ads_account_setup
Meta account setup
Pixels, pages, lead forms and conversion events of a client's Meta ad account.
Parametersclient_idrequired
meta_ads_interest_search
Search Meta interests
Targeting interests matching a keyword, with id, name, audience size and topic.
Parameterslimitqueryrequiredclient_idrequired
meta_ads_learning_phase
Meta learning phase
Learning status of every active ad set of a client, with what holds learning back.
Parametersclient_idrequiredcampaign_idtarget_cpa_usd
meta_ads_placement_safety_check
Check risky Meta placements
Shows which ad sets of a client's active Meta campaigns still run on fraud-prone placements and what the safe targeting would be. Read-only.
Parametersclient_idrequiredobjectiveinclude_bot_audience
tiktok_ads_account_setup
TikTok account setup
Pixels, identities and account details of a client's TikTok ad account.
Parametersclient_idrequired
linkedin_ads_account_setup
LinkedIn account setup
Conversions, campaign groups and account details of a client's LinkedIn ad account.
Parametersclient_idrequired
microsoft_ads_account_setup
Microsoft Ads account setup
UET tags, conversion goals and account details of a client's Microsoft Ads account.
Parametersclient_idrequired
telegram_ads_status
Telegram Ads status
Connected Telegram Ads accounts, their goal and currency, and what is automated versus done by hand.
Parametersclient_id
telegram_ads_policy_check
Check a Telegram ad
Checks a sponsored message against Telegram's prohibited categories, the 160-character text limit, the title limit and the link format.
Parameterscpmtextrequiredtitlecurrencyclient_idpromote_urlwebsite_name
telegram_ads_verify_channel
Verify a Telegram channel
Whether a channel exists, is public and how many subscribers it has.
Parametersusernamerequired
telegram_ads_targeting
Telegram targeting options
Languages, topics with their ids and countries, read from Telegram Ads itself for one connected account.
Parametersaccount_idrequired
chatgpt_ads_status
ChatGPT Ads status
Connected ChatGPT Ads accounts, campaigns, ad review statuses and what blocks delivery.
Parametersclient_id
chatgpt_ads_policy_check
Check a ChatGPT ad
Whether ChatGPT Ads policy admits this business and whether the texts fit the limits (title 50, body 100).
Parametersurlbodytexttitleclient_idcontext_hints
creative_fatigue_report
Creative fatigue report
Campaigns of a client with high frequency and falling CTR, ranked by how tired the creative is.
Parametersclient_idrequiredthreshold_frequency
creative_image_analyze
Analyse an ad image
Reviews an ad image for platform fit, visual hierarchy, call-to-action legibility and brand fit. AI: 1 AI request.
Parameterscontextplatformimage_urlrequired
creative_banner_quality_check
Check a banner's quality
Reviews a generated banner of ADS Beast for garbled text, legibility, platform spec fit and visual quality, with a score and fixes. Takes up to a minute. AI: 1 AI request.
Parametersplatformcreative_idrequiredformat_label
creative_prompt_templates
Banner prompt templates
A library of prompts for generating ad banners, filtered by business vertical and visual style.
Parametersstylevertical
creative_copy_humanize
Check copy for AI tells
Scores a text 0-100 for signs of machine writing, lists the markers found and returns a cleaned version. It never invents facts.
Parameterstextrequiredsurface
competitor_list
List competitors
Competitors on record with site, niche, collected ads and keywords.
Parameterswith_adsclient_id
competitor_search_intel
Research competitors
Searches the web for a competitor's ads, positioning, pricing, selling points and reviews.
Parametersnicheaspectclient_idcompetitor_domain
competitor_ads_research
Research competitor ads
Competitors in a niche and country with their headlines, angles and calls to action. The response says whether an item was observed in an ad library or inferred. AI: 1 AI request.
Parametersgeonicheclient_id
competitor_site_analyze
Analyse a competitor site
Reads one competitor site: selling points, prices, technology, pixels, call-to-action patterns and audience signals.
Parametersurlrequiredclient_idrequired
competitor_social_signals
Competitor social signals
A competitor's recent activity outside its site: YouTube, blog feed, public posts and community mentions.
Parametersclient_idrequiredcompetitor_urlrequired
competitor_aeo_benchmark
AI visibility benchmark
Compares how often AI models mention the client versus competitors for the same prompts. AI: 1 AI request.
Parametersclient_idrequiredcompetitors
leads_quality_diagnose
Diagnose lead quality
Works out where a campaign loses lead quality and what to change, from the numbers and complaints supplied. Takes up to a minute. Amounts are in the ad account's own currency, in whole units (not cents or micros). AI: 1 AI request. May return a job_id (get_job_result).
Parameterscpactrspendclicksplatformrequiredclient_idtarget_cpaconversionscampaign_namerequiredlead_complaintslanding_page_url
leads_meta_ingest_check
Check Meta leads waiting
Shows which Meta instant-form leads of a client would be imported. Read-only.
Parametersclient_idrequiredlookback_hours
social_calendar
Social content calendar
Scheduled and published social posts of a client.
Parametersstatusplatformclient_idrequired
Keyword clusters, audience pain points, pre-purchase questions and competitor analysis for a client's site. Takes minutes. AI: 1 AI request. May return a job_id (get_job_result).
Parametersclient_idrequiredmax_parallelcompetitor_urls
seo_rank_changes
Keyword rank changes
Position changes over 7-30 days: winners, drops and keywords in positions 11-30.
Parametersdaysclient_idrequired
seo_brief_generate
Generate an SEO brief
A content brief for one keyword: headings, meta tags, structure, related terms, length. AI: 1 AI request. May return a job_id (get_job_result).
Parametersgeourlkeywordrequiredlanguageclient_id
seo_keyword_rank_check
Check a keyword position
A site's Google position for one keyword with the matched URL, SERP features and the top ten.
Parametersglhldomainrequiredkeywordrequired
seo_keyword_research
Keyword research
Keyword clusters with intent, priority and AI-citation potential for a topic. AI: 1 AI request.
Parametersgeotopicrequiredlanguageclient_idseed_keywords
seo_content_gap
Content gap analysis
Topics competitors cover and this site does not, with an action plan. AI: 1 AI request. May return a job_id (get_job_result).
Parametersgeonichedomainclient_idcompetitors
seo_performance_report
SEO performance report
An SEO and AI-visibility report for a client or domain. AI: 1 AI request.
Parametersdomainperiodclient_idreport_type
seo_backlink_analysis
Backlink analysis
Backlink profile quality, toxic links and link-building opportunities. AI: 1 AI request.
Parametersdomainrequiredclient_idcompetitors
seo_competitor_analysis
SEO competitor analysis
Competitors' search presence, content strategy, links and AI visibility, with gaps and opportunities. AI: 1 AI request.
Parametersgeonichedomainclient_idcompetitorsrequired
seo_serp_analysis
SERP analysis
What ranks for a query and why: content types, featured snippets, AI overviews, People Also Ask. AI: 1 AI request.
Parametersgeokeywordrequiredlanguageclient_id
seo_technical_audit
Technical SEO audit
Core Web Vitals, crawlability, indexability, structured data, redirects, canonicals, mobile, HTTPS, robots.txt and sitemap. AI: 1 AI request.
Parametersurlrequireddepthclient_id
seo_on_page_audit
On-page SEO audit
One page audited across title, meta description, headings, content, keywords, internal links, images and technical basics. AI: 1 AI request.
Parametersurlrequiredkeywordclient_id
seo_internal_links_audit
Internal links audit
Orphan and weakly linked pages with the internal links to add. AI: 1 AI request.
Parametersdomainrequiredclient_idkey_pages
seo_content_quality_audit
Content quality audit
An 80-criteria content quality audit (clarity, organisation, referenceability, experience, expertise, authority, trust) for a URL or a text. AI: 1 AI request.
Parametersurlcontentclient_idcontent_type
seo_domain_authority_audit
Domain authority audit
A 40-criteria audit of domain authority: citation, identity, trust and eminence. AI: 1 AI request.
Parametersdomainrequiredclient_idsite_type
seo_entity_audit
Brand entity audit
How well a brand is established as an entity for Google's Knowledge Graph and AI systems, with a plan to build it. AI: 1 AI request.
Parametersdomainindustryclient_idbrand_namerequired
seo_ai_citation_optimize
Optimise for AI citation
Rewrites guidance for a page or text so AI answers can quote it: definition blocks, quotable statements, FAQ. AI: 1 AI request.
Parametersurlcontentkeywordclient_id
aeo_visibility_scan
AI visibility scan
How often AI models mention a client's brand for the queries of its niche: a 0-100 score, a per-model breakdown and the quotes. AI: 1 AI request. May return a job_id (get_job_result).
Parametersclient_idrequiredcompetitors
aeo_mention_opportunities
Find mention opportunities
Fresh discussions where people ask for recommendations in a client's niche, with a suggested reply. AI: 1 AI request.
Parameterslimitclient_idrequired
reddit_mentions_monitor
Monitor Reddit mentions
New Reddit threads mentioning a client's brand, keywords or competitors, with sentiment and a draft reply. AI: 1 AI request.
Parametersclient_idrequired
reddit_opportunities
Find Reddit opportunities
Buyer-intent Reddit threads in a client's niche, ranked.
Parametersclient_idrequired
reddit_amplification_plan
Plan Reddit promotion
For one page: relevant subreddits, two post drafts and the best time to post. A plan only; nothing is posted. AI: 1 AI request.
Parametersclient_idrequiredcontent_urlrequired
Create a task for the team in ADS Beast.
Parameterstitlerequiredcategorydue_datepriorityrequiredclient_iddescription
task_suggest
Suggest tasks from problems
Scans clients for unanswered critical alerts, KPI goals at risk, campaigns without metrics and projected overspend, and creates tasks for the team. dry_run=true only lists what it found.
Parametersdry_runclient_id
report_create
Create a report
Save a report for a client. With content: stores that text (Markdown). Without content: generates a 30-day campaign summary. AI: 1 AI request.
Parameterstitlecontentclient_idrequired
recommendation_save
Save a recommendation
Record a recommendation so ADS Beast checks in seven days whether it worked.
Parametersactionrequiredmetricrequiredclient_idreasoningcampaign_idtarget_valuecurrent_value
ab_test_create
Create an A/B test record
Register an A/B test in ADS Beast to track its hypothesis and variants. It records the test; it does not change ads.
Parametersnamerequiredclient_idhypothesisrequiredcampaign_idwhat_testedrequiredvariant_a_namerequiredvariant_b_namerequiredvariant_a_descriptionvariant_b_description
creative_copy_generate
Generate ad copy
Generate ad variants (headlines, texts, calls to action) for a client and save them as drafts. Takes up to a minute. AI: 1 AI request.
Parameterstonecountad_typeplatformrequiredclient_idrequired
creative_fatigue_check
Run a creative fatigue check
Checks Meta and TikTok campaigns for tired creatives now and files an alert and a change proposal for each one found. Proposals wait for a person.
Parametersclient_idcampaign_id
seo_article_generate
Generate an SEO article draft
Writes an SEO article for a keyword and saves it as a draft. Nothing is published. Takes up to a minute. AI: 1 AI request.
Parameterskeywordrequiredclient_idrequiredword_count
seo_content_write
Write SEO content
Writes search- and AI-citation-ready content on a topic and saves it as a draft. Takes up to a minute. AI: 1 AI request. May return a job_id (get_job_result).
Parametersgeotopicrequiredclient_idword_countcontent_type
seo_meta_tags_optimize
Optimise meta tags
Returns improved title, meta description, Open Graph and Twitter Card tags for a page and stores the suggestion. AI: 1 AI request.
Parametersurlrequiredkeywordclient_idbrand_namecontent_summary
seo_schema_generate
Generate schema markup
Schema.org JSON-LD for a page (FAQ, HowTo, Article, Product, LocalBusiness, Organization), stored as a suggestion. AI: 1 AI request.
Parametersurlcontentclient_idbrand_nameschema_type
seo_site_check
Run a site SEO check
Positions, technical state and a prioritised task list for a client's site; the tasks are saved in ADS Beast.
Parametersclient_idrequiredwebsite_url
seo_keywords_track
Track keyword positions
Checks positions now, records them and reports changes and quick wins. AI: 1 AI request.
Parametersgeodomainkeywordsclient_id
seo_alerts_configure
Configure SEO alerts
Set alert thresholds for traffic, positions, backlinks, Core Web Vitals and AI visibility of a domain. AI: 1 AI request. May return a job_id (get_job_result).
Parametersdomainrequiredclient_idkey_keywordsbaseline_trafficnotification_channel
aeo_content_optimize
Optimise a page for AI answers
Reformats a client's page for citation by AI models (Q&A version, FAQ blocks, JSON-LD) and saves the recommendations. AI: 1 AI request.
Parameterspage_urlrequiredclient_idrequiredfocus_query
reddit_reply_draft
Draft a Reddit reply
Drafts a reply to a Reddit thread and saves it as a task for a person to review and post. Nothing is posted. AI: 1 AI request.
Parametersclient_idthread_urlrequiredbrand_anglerequired
client_market_simulation_request
Request a market simulation
Ask for a multi-agent market simulation for a client. It is queued as a request a person confirms, because it costs model usage.
Parametersclient_idrequiredrequirementrequired
telegram_ads_draft_generate
Draft a Telegram ad
Builds a ready-to-submit Telegram ad within the 160-character limit with bid, budget and an impressions estimate, and reports whether it passes preflight. Amounts are in the Telegram account currency.
Parameterscpmtextrequiredtitlebudgetbuttoncurrencyclient_idplacementautoshortenpromote_urlwebsite_name
telegram_ads_publish_task
Queue a Telegram ad for manual publishing
Creates a task for an operator to paste a checked ad into ads.telegram.org by hand. The path for accounts without an API token.
Parameterscpmtextrequiredtitlebudgetcurrencyclient_idpromote_urlrequiredwebsite_namecampaign_namerequired
chatgpt_ads_draft_generate
Draft a ChatGPT Ads campaign
Builds intent clusters and ad texts within the platform limits from a business description and returns them for review. Nothing is published. Takes up to a minute. AI: 1 AI request.
Parametersgeourlbusinessrequiredclusterslanguageclient_idads_per_cluster
campaign_draft_edit
Edit campaign draft targeting and ads
Low-level edit of a campaign draft before publishing: merge targeting keys, update ads, replace ad groups, rename, change goal, budget or UTM. Nothing is sent to the platform. Amounts are in the ad account's own currency, in whole units (not cents or micros).
Parametersnamebuild_idrequiredad_groupsclient_idrequiredobjectivetargetingad_updatesutm_paramsbudget_typebudget_amount
chatgpt_ads_review_sync
Refresh ChatGPT Ads review status
Asks ChatGPT Ads for the review status of a campaign's ads and stores it in ADS Beast. Nothing is enabled: a campaign with no approved ad must stay off.
Parameterschatgpt_campaign_idrequired
leads_meta_ingest
Import Meta leads now
Pulls a client's Meta instant-form leads into ADS Beast now (scored, de-duplicated, forwarded to the client's webhooks). Idempotent.
Parametersclient_idrequiredlookback_hours
prepare_campaign_pause
Prepare pausing a campaign
Prepare pausing one campaign. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
Parametersreasonrequiredcampaign_idrequired
prepare_campaign_enable
Prepare enabling a campaign
Prepare switching one paused campaign back on. Enabling always waits for a person, whatever the client's write policy. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
Parametersreasonrequiredcampaign_idrequired
prepare_campaign_budget_change
Prepare a budget change
Prepare a new monthly budget for one campaign. new_monthly_budget is in the ad account's own currency, in whole units (3000 means 3000.00, never cents or micros); the preview shows the daily amount and the exact figure the platform will receive. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
Parametersreasonrequiredcurrencycampaign_idrequirednew_monthly_budgetrequired
prepare_negative_keywords_add
Prepare adding negative keywords
Prepare negative keywords for a client's Google Ads account: a shared list attached to the named campaigns, or to every enabled Search, Shopping and Display campaign. If it cannot be attached anywhere, nothing is left behind. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
Parametersreasonrequiredkeywordsrequiredclient_idrequiredlist_namecampaign_ids
prepare_campaign_draft_publish
Prepare publishing a campaign draft
Prepare creating a full campaign in Google Ads or Meta from a campaign draft. The campaign is created PAUSED: it does not serve and spends nothing until a person enables it separately. The preview carries the rehearsal against the live account. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
Parametersreasonrequiredbuild_idrequiredclient_idrequiredplatform_campaign_id
prepare_ad_create
Prepare creating an ad
Prepare a new ad inside an existing campaign: a responsive search ad on Google (headlines, descriptions, final_url) or a single-image ad on Meta (headline, body). Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
Parametersbodynamerequiredreasonrequiredheadlinefinal_urlheadlinescampaign_idrequireddescriptions
prepare_meta_ad_set_create
Prepare creating a Meta ad set
Prepare a new ad set inside an existing Meta campaign. The ad set is created PAUSED. daily_budget is in whole units of the account currency (20 means 20.00); the preview shows the figure Meta receives. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
Parametersnamerequiredreasonrequiredtargetingrequiredcampaign_idrequireddaily_budgetrequiredoptimization_goal
prepare_campaign_bid_strategy_change
Prepare a bid strategy change
Prepare a new bid strategy for one campaign, with its target cost per conversion or target ROAS. target_cpa is in whole units of the account currency; the preview shows the figure the platform receives. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
Parametersreasonrequiredtarget_cpacampaign_idrequiredtarget_roasbid_strategyrequired
prepare_meta_audiences_create
Prepare creating Meta audiences
Prepare website custom audiences and lookalikes in a client's Meta account. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
Parametersreasonrequiredclient_idrequiredaudience_types
prepare_meta_placement_safety_apply
Prepare excluding risky Meta placements
Prepare removing fraud-prone placements from every ad set of a client's active Meta campaigns. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
Parametersreasonrequiredclient_idrequiredobjectiveinclude_bot_audience
prepare_google_conversion_action_create
Prepare a Google conversion action
Prepare creating a conversion action in a client's Google Ads account; the result carries the tag code for the site. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
Parametersnamerequiredreasonrequiredcategoryclient_idrequiredaccount_id
prepare_google_app_videos_add
Prepare adding videos to an App campaign
Prepare adding videos to a Google App campaign. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
Parameterstitlereasonrequiredclient_idrequiredaccount_idvideo_urlscampaign_idrequiredyoutube_videos
prepare_google_rsa_variations
Prepare new Google search ad variations
Prepare additional responsive search ads for a client's Google campaigns. New ads are created paused. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
Parametersreasonrequiredclient_idrequiredcampaign_idsad_variationsrequiredverify_ad_strengthrequire_full_assetscreate_missing_ad_groupsmin_new_ads_per_campaign
prepare_google_keyword_overlap_fix
Prepare pausing duplicate keywords
Prepare pausing the duplicate copies of keywords that are enabled in several active Google campaigns of one account. The newest campaign keeps the keyword. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
Parametersreasonrequiredclient_idrequired
prepare_telegram_ad_publish
Prepare publishing a Telegram ad
Prepare creating an ad in Telegram Ads through its API. The ad is created paused. cpm and daily_budget_limit are in the Telegram account's currency. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
Parameterscpmrequiredtexttitlerequiredbuttonreasonrequiredplacementaccount_idrequiredpromote_urlrequiredwebsite_namelanguage_codesdaily_budget_limit
prepare_chatgpt_ads_publish
Prepare publishing a ChatGPT Ads campaign
Prepare uploading a prepared ChatGPT Ads campaign to the platform. Everything is created paused and passes the policy check first; it spends nothing until its ads are approved and a person enables it. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
Parametersreasonrequiredchatgpt_campaign_idrequired
prepare_meta_audience_create
Prepare creating one Meta audience
Prepare one custom audience (customer list, website pixel, app or offline) or one lookalike in a client's Meta account. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
Parametersnamerequiredratioreasonrequiredcountrysubtypepixel_idclient_idrequiredaudience_typerequiredretention_dayssource_audience_id
prepare_article_distribution
Prepare social posts for an article
Prepare drafting social posts that announce a blog article of a client on the chosen channels. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
Parametersreasonrequiredchannelsrequiredarticle_idrequired
prepare_client_report_send
Prepare sending a client report
Prepare generating the monthly report for a client and emailing it to the client's address on record. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
Parametersreasonrequiredclient_idrequiredsend_email
prepare_social_post_schedule
Prepare scheduling a social post
Prepare publishing or scheduling a post on a client's connected social channel. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
Parameterstextrequiredreasonrequiredplatformrequiredclient_idrequiredimage_urlscheduled_at
prepare_content_refresh
Prepare a content refresh
Prepare a refresh plan for an outdated page: what to rewrite, update or remove. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
Parametersurlrequiredreasonrequiredcontentclient_idpublish_date
execute_prepared_change
Request execution of a prepared change
Step 2 of every change: submit one preview made by a prepare_* tool. Only that stored preview runs - this tool takes no other argument, so the change cannot differ from what was shown. A preview works once, for 15 minutes, and is refused when the campaign changed in the meantime. The answer says whether the change now waits for a person's approval in ADS Beast (the default) or is being applied under the client's write policy. This connector cannot approve.
Parameterspreview_idrequired
get_job_result
Result of a long tool call
Result of a call that answered status running with a job_id: running (poll in 15 s), done with the result, failed with why, or expired (24 h). Same key only; not metered.
Parametersjob_idrequired
get_prepared_change
Status of a prepared change
What became of a preview: still ready, expired, or submitted - and then the proposal's status (pending, executed, rejected, failed) with the execution result.
Parameterspreview_idrequired