Skip to main content

get_actions

Get prioritized action recommendations for a brand. Shows impact scores, effort levels, quick wins, and how-to-fix instructions.

Parameters

ParameterTypeRequiredDescription
brandIdstringYesThe brand ID from list_brands
statusstringNoFilter by status: PENDING, IN_PROGRESS, COMPLETED, DISMISSED
categorystringNoFilter by category: TECHNICAL, CONTENT, AEO, AUTHORITY, VISIBILITY
quickWinsOnlybooleanNoOnly return quick win actions
limitnumberNoMax actions to return (default: 20)

OAuth Scope

Requires: read:actions

get_brand_perception

Get brand perception analysis: sentiment, alignment, consistency scores, and SWOT insights (strengths, weaknesses, opportunities, threats).

Parameters

ParameterTypeRequiredDescription
brandIdstringYesThe brand ID from list_brands

Returns

FieldDescription
snapshot.sentimentScoreOverall sentiment score
snapshot.alignmentScoreAlignment with brand positioning
snapshot.consistencyScoreConsistency across AI providers
strengths[]Brand strengths identified by AI
weaknesses[]Areas of improvement
opportunities[]Growth opportunities
threats[]Potential threats

OAuth Scope

Requires: read:visibility

get_technical_status

Get technical SEO status: robots.txt, llms.txt, sitemap.xml analysis, blocked AI crawlers, and open page issues by severity.

Parameters

ParameterTypeRequiredDescription
brandIdstringYesThe brand ID from list_brands

Returns

FieldDescription
technical.robotsStatusrobots.txt analysis status
technical.llmsStatusllms.txt analysis status
technical.sitemapStatussitemap.xml analysis status
technical.blockedCrawlers[]AI crawlers blocked by robots.txt
issuesOpen issues count by severity (critical, high, medium, low)
topIssues[]Most important open issues

OAuth Scope

Requires: read:visibility

get_prompt_signals

Get prompt signal analysis: attack/defend/monitor/ignore labels based on Share of Voice and market openness. Identifies which prompts to invest in.

Parameters

ParameterTypeRequiredDescription
brandIdstringYesThe brand ID from list_brands
limitnumberNoMax prompts per category (default: 5)

Returns

FieldDescription
summary.attackCountPrompts where market is open and brand is underrepresented
summary.defendCountPrompts where brand has strong position to defend
summary.monitorCountPrompts to keep watching
summary.ignoreCountLow-priority prompts
topAttackPrompts[]Best attack opportunities (high openness, low SOV)
topDefendPrompts[]Positions to defend (high SOV)

OAuth Scope

Requires: read:prompts