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.
無需輸入參數。
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.
輸入參數limitsincestageoffsetsourceclient_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.
輸入參數lead_id必填
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.
輸入參數limitoffsetplatformclient_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.
輸入參數daysclient_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.
無需輸入參數。
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.
輸入參數fields必填lead_id必填
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.
輸入參數stage必填lead_id必填
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.
輸入參數rows必填dry_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.
輸入參數limitoffsetplatformclient_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.
輸入參數campaign_id必填
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.
無需輸入參數。
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}.
輸入參數limitoffset
Return a single client by its ADS Beast id: profile, budget, goals and connected advertising accounts.
輸入參數client_id必填
list_reports
List generated reports
Return the client reports already generated in ADS Beast, newest first, with their type, period and client.
輸入參數limitoffsetclient_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.
輸入參數limitoffsetis_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.
無需輸入參數。
list_tasks
List team tasks
Return the team tasks recorded in ADS Beast with their status, priority, assignee and the client they belong to.
輸入參數limitoffsetstatuspriorityclient_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.
輸入參數limitoffsetclient_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.
輸入參數campaign_id必填
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.
輸入參數limitoffset
list_social_campaigns
List social prospecting campaigns
Return the Instagram/TikTok/Facebook prospecting campaigns: offer, platforms, cities with message language, daily manual-send cap.
輸入參數limitoffsetclient_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.
輸入參數limitplatformcampaign_id必填
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.
輸入參數notestatusprospect_id必填
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.
無需輸入參數。
list_webhooks
List registered webhooks
Return the outbound webhook endpoints registered for this organization, the events each one receives and its current delivery state.
輸入參數limitoffset
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.
輸入參數url必填name必填events必填client_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.
輸入參數client_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.
輸入參數limitoffsetstatusclient_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.
輸入參數change必填reason必填client_idnew_budgetcampaign_id必填
reject_proposal
Reject a change proposal
Reject a pending proposal with a short reason. Returns the proposal id and its new status.
輸入參數reasonproposal_id必填
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.
輸入參數platform
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.
輸入參數limitoffsetstatusclient_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.
輸入參數draft_id必填
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.
輸入參數geoname必填extranotesaudienceplatform必填ad_groupsclient_id必填languagesconversiontarget_cpalanding_url另有 5 個
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.
輸入參數geonameextranotesaudiencedraft_id必填ad_groupslanguagesconversiontarget_cpalanding_urltarget_roas另有 3 個
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.
輸入參數client_id必填
client_overview
Client overview
One client with its campaigns, key metrics and goals.
輸入參數client_id必填
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.
輸入參數client_id必填
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.
輸入參數client_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.
輸入參數client_id
client_memory_search
Search client memory
Search the facts, decisions, preferences and brand notes ADS Beast has stored about clients.
輸入參數query必填client_id
client_history_search
Search past reports and audits
Full-text search over a client's earlier reports, audits and analyses.
輸入參數limitquery必填client_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.
輸入參數urlclient_id
client_market_analysis
Get market analysis
The stored market analysis of a client: summary, competitor matrix, audience signals and the draft campaign strategy.
輸入參數sectionclient_id必填
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.
輸入參數forceclient_id必填
client_market_intel_search
Search market intelligence
Semantic search over a client's indexed market data: its site, competitor profiles and the market report.
輸入參數query必填top_kclient_id必填
client_market_simulation
Get market simulation
Status and report of the multi-agent market simulations requested for a client.
輸入參數client_id必填
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.
輸入參數daysplatformclient_id必填
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.
輸入參數platformclient_id必填current_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.
輸入參數client_id必填campaign_id
analytics_forecast_warnings
Forecast warnings
Campaigns expected to break a KPI target within days, from a linear trend.
輸入參數client_id必填
analytics_attribution
Attribution breakdown
Time-decay multi-touch attribution for a client's campaigns: attributed conversions, attributed CPA and the lift against last click.
輸入參數daysclient_id必填
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.
輸入參數daysplatform
analytics_cross_client_insights
Cross-client insights
Patterns and anomalies across clients: platforms that sag for most of them, shared niche problems, who outperforms.
輸入參數daysplatform
analytics_kpi_health
KPI health check
Quick status of all active campaigns: how many are on target and how many need attention.
輸入參數client_id
analytics_growth_opportunities
Growth opportunities
Campaigns ready to scale: ROAS well above target, CPA well below target, or budget left unused.
輸入參數client_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.
輸入參數nicheplatform必填
analytics_agency_briefing
Daily briefing
Morning briefing for the workspace: critical alerts, today's tasks and what needs attention now.
無需輸入參數。
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.
輸入參數nichecurrencyplatform必填client_idnum_objectsmonthly_budget必填avg_order_valuegross_margin_pctobjective_or_type必填
analytics_ab_tests
List A/B tests
A/B tests with their status and interim results.
輸入參數limitstatusclient_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.
輸入參數platformclient_id必填
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.
輸入參數depthclient_id必填
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.
輸入參數client_id必填
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.
輸入參數client_id必填
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.
輸入參數client_id必填
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.
輸入參數client_id必填
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.
輸入參數daysclient_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.
輸入參數client_idonly_active
audit_campaign_health
Campaign health summary
A 1-10 health score for each campaign of a client with the problems behind it.
輸入參數client_id必填
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.
輸入參數client_id必填
audit_ad_disapprovals
List disapproved ads
Ads the platforms rejected, with the reason and the policy code.
輸入參數statusplatformclient_id
recommendation_list
List open recommendations
Open recommendation cards: agent advice and Meta's own cabinet advice, judged against the client's goal.
輸入參數limitsourceplatformclient_id
campaign_search
Search campaigns by name
Campaigns filtered by client, platform, status or a substring of the name.
輸入參數limitstatusplatformclient_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.
輸入參數dayscampaign_id必填
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.
輸入參數daysproblem必填campaign_id必填
campaign_history_analysis
Analyse campaign history
What worked for a client before: average CPA and CTR, best campaigns and best audiences.
輸入參數client_id必填
campaign_type_coverage
Campaign type coverage
Which campaign types ADS Beast supports on each platform and how far: creation through the API, generation, validation.
輸入參數platform
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).
輸入參數focusclient_id必填horizon_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).
輸入參數geoplatformclient_id必填objectiveextra_contextbudget_monthly
campaign_swarm_runs
List campaign generation runs
Recent multi-agent campaign generation runs with status, platform and budget.
輸入參數limitclient_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.
輸入參數build_id必填client_id必填
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.
輸入參數build_id必填client_id必填platform_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.
輸入參數client_id必填force_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.
輸入參數client_id必填
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).
輸入參數action必填new_valuecampaign_id必填
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.
輸入參數name必填categoryclient_id必填account_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.
輸入參數titleclient_id必填account_idvideo_urlscampaign_id必填youtube_videos
meta_ads_account_setup
Meta account setup
Pixels, pages, lead forms and conversion events of a client's Meta ad account.
輸入參數client_id必填
meta_ads_interest_search
Search Meta interests
Targeting interests matching a keyword, with id, name, audience size and topic.
輸入參數limitquery必填client_id必填
meta_ads_learning_phase
Meta learning phase
Learning status of every active ad set of a client, with what holds learning back.
輸入參數client_id必填campaign_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.
輸入參數client_id必填objectiveinclude_bot_audience
tiktok_ads_account_setup
TikTok account setup
Pixels, identities and account details of a client's TikTok ad account.
輸入參數client_id必填
linkedin_ads_account_setup
LinkedIn account setup
Conversions, campaign groups and account details of a client's LinkedIn ad account.
輸入參數client_id必填
microsoft_ads_account_setup
Microsoft Ads account setup
UET tags, conversion goals and account details of a client's Microsoft Ads account.
輸入參數client_id必填
telegram_ads_status
Telegram Ads status
Connected Telegram Ads accounts, their goal and currency, and what is automated versus done by hand.
輸入參數client_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.
輸入參數cpmtext必填titlecurrencyclient_idpromote_urlwebsite_name
telegram_ads_verify_channel
Verify a Telegram channel
Whether a channel exists, is public and how many subscribers it has.
輸入參數username必填
telegram_ads_targeting
Telegram targeting options
Languages, topics with their ids and countries, read from Telegram Ads itself for one connected account.
輸入參數account_id必填
chatgpt_ads_status
ChatGPT Ads status
Connected ChatGPT Ads accounts, campaigns, ad review statuses and what blocks delivery.
輸入參數client_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).
輸入參數urlbodytexttitleclient_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.
輸入參數client_id必填threshold_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.
輸入參數contextplatformimage_url必填
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.
輸入參數platformcreative_id必填format_label
creative_prompt_templates
Banner prompt templates
A library of prompts for generating ad banners, filtered by business vertical and visual style.
輸入參數stylevertical
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.
輸入參數text必填surface
competitor_list
List competitors
Competitors on record with site, niche, collected ads and keywords.
輸入參數with_adsclient_id
competitor_search_intel
Research competitors
Searches the web for a competitor's ads, positioning, pricing, selling points and reviews.
輸入參數nicheaspectclient_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.
輸入參數geonicheclient_id
competitor_site_analyze
Analyse a competitor site
Reads one competitor site: selling points, prices, technology, pixels, call-to-action patterns and audience signals.
輸入參數url必填client_id必填
competitor_social_signals
Competitor social signals
A competitor's recent activity outside its site: YouTube, blog feed, public posts and community mentions.
輸入參數client_id必填competitor_url必填
competitor_aeo_benchmark
AI visibility benchmark
Compares how often AI models mention the client versus competitors for the same prompts. AI: 1 AI request.
輸入參數client_id必填competitors
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).
輸入參數cpactrspendclicksplatform必填client_idtarget_cpaconversionscampaign_name必填lead_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.
輸入參數client_id必填lookback_hours
social_calendar
Social content calendar
Scheduled and published social posts of a client.
輸入參數statusplatformclient_id必填
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).
輸入參數client_id必填max_parallelcompetitor_urls
seo_rank_changes
Keyword rank changes
Position changes over 7-30 days: winners, drops and keywords in positions 11-30.
輸入參數daysclient_id必填
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).
輸入參數geourlkeyword必填languageclient_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.
輸入參數glhldomain必填keyword必填
seo_keyword_research
Keyword research
Keyword clusters with intent, priority and AI-citation potential for a topic. AI: 1 AI request.
輸入參數geotopic必填languageclient_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).
輸入參數geonichedomainclient_idcompetitors
seo_performance_report
SEO performance report
An SEO and AI-visibility report for a client or domain. AI: 1 AI request.
輸入參數domainperiodclient_idreport_type
seo_backlink_analysis
Backlink analysis
Backlink profile quality, toxic links and link-building opportunities. AI: 1 AI request.
輸入參數domain必填client_idcompetitors
seo_competitor_analysis
SEO competitor analysis
Competitors' search presence, content strategy, links and AI visibility, with gaps and opportunities. AI: 1 AI request.
輸入參數geonichedomainclient_idcompetitors必填
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.
輸入參數geokeyword必填languageclient_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.
輸入參數url必填depthclient_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.
輸入參數url必填keywordclient_id
seo_internal_links_audit
Internal links audit
Orphan and weakly linked pages with the internal links to add. AI: 1 AI request.
輸入參數domain必填client_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.
輸入參數urlcontentclient_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.
輸入參數domain必填client_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.
輸入參數domainindustryclient_idbrand_name必填
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.
輸入參數urlcontentkeywordclient_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).
輸入參數client_id必填competitors
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.
輸入參數limitclient_id必填
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.
輸入參數client_id必填
reddit_opportunities
Find Reddit opportunities
Buyer-intent Reddit threads in a client's niche, ranked.
輸入參數client_id必填
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.
輸入參數client_id必填content_url必填
Create a task for the team in ADS Beast.
輸入參數title必填categorydue_datepriority必填client_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.
輸入參數dry_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.
輸入參數titlecontentclient_id必填
recommendation_save
Save a recommendation
Record a recommendation so ADS Beast checks in seven days whether it worked.
輸入參數action必填metric必填client_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.
輸入參數name必填client_idhypothesis必填campaign_idwhat_tested必填variant_a_name必填variant_b_name必填variant_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.
輸入參數tonecountad_typeplatform必填client_id必填
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.
輸入參數client_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.
輸入參數keyword必填client_id必填word_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).
輸入參數geotopic必填client_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.
輸入參數url必填keywordclient_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.
輸入參數urlcontentclient_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.
輸入參數client_id必填website_url
seo_keywords_track
Track keyword positions
Checks positions now, records them and reports changes and quick wins. AI: 1 AI request.
輸入參數geodomainkeywordsclient_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).
輸入參數domain必填client_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.
輸入參數page_url必填client_id必填focus_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.
輸入參數client_idthread_url必填brand_angle必填
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.
輸入參數client_id必填requirement必填
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.
輸入參數cpmtext必填titlebudgetbuttoncurrencyclient_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.
輸入參數cpmtext必填titlebudgetcurrencyclient_idpromote_url必填website_namecampaign_name必填
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.
輸入參數geourlbusiness必填clusterslanguageclient_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).
輸入參數namebuild_id必填ad_groupsclient_id必填objectivetargetingad_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.
輸入參數chatgpt_campaign_id必填
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.
輸入參數client_id必填lookback_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.
輸入參數reason必填campaign_id必填
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.
輸入參數reason必填campaign_id必填
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.
輸入參數reason必填currencycampaign_id必填new_monthly_budget必填
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.
輸入參數reason必填keywords必填client_id必填list_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.
輸入參數reason必填build_id必填client_id必填platform_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.
輸入參數bodyname必填reason必填headlinefinal_urlheadlinescampaign_id必填descriptions
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.
輸入參數name必填reason必填targeting必填campaign_id必填daily_budget必填optimization_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.
輸入參數reason必填target_cpacampaign_id必填target_roasbid_strategy必填
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.
輸入參數reason必填client_id必填audience_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.
輸入參數reason必填client_id必填objectiveinclude_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.
輸入參數name必填reason必填categoryclient_id必填account_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.
輸入參數titlereason必填client_id必填account_idvideo_urlscampaign_id必填youtube_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.
輸入參數reason必填client_id必填campaign_idsad_variations必填verify_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.
輸入參數reason必填client_id必填
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.
輸入參數cpm必填texttitle必填buttonreason必填placementaccount_id必填promote_url必填website_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.
輸入參數reason必填chatgpt_campaign_id必填
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.
輸入參數name必填ratioreason必填countrysubtypepixel_idclient_id必填audience_type必填retention_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.
輸入參數reason必填channels必填article_id必填
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.
輸入參數reason必填client_id必填send_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.
輸入參數text必填reason必填platform必填client_id必填image_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.
輸入參數url必填reason必填contentclient_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.
輸入參數preview_id必填
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.
輸入參數job_id必填
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.
輸入參數preview_id必填