get_visibility_actions

Get prioritized action items to improve AI visibility — content to create, sources to reach, and technical fixes.

Get prioritized action items to improve AI visibility. Actions are generated from scan recommendations and include content to create, sources to reach out to, and technical improvements. Filter by status or priority to focus on what matters.

Authentication: Required

Parameters

Parameter	Type	Required	Description
`syntheticId`	`integer`	Yes	The agent ID to get actions for.
`status`	`"pending" \| "in_progress" \| "completed" \| "dismissed"`	No	Filter by action status. Returns all statuses if omitted.
`priority`	`"high" \| "medium" \| "low"`	No	Filter by priority level.

Response

{
  "syntheticId": 1234,
  "brandName": "Example",
  "actionCount": 8,
  "pendingCount": 5,
  "actions": [
    {
      "id": "act-abc123",
      "actionType": "create_content",
      "category": "content",
      "title": "Write a comparison guide: Example vs CompetitorX",
      "description": "AI platforms frequently mention CompetitorX but not Example in comparison queries. A detailed comparison post would help.",
      "priority": "high",
      "status": "pending",
      "targetUrl": null,
      "relatedQueries": ["best tools for X", "Example vs CompetitorX"],
      "createdAt": "2026-03-20T12:00:00Z",
      "completedAt": null
    }
  ]
}

Action types

Type	Description
`create_content`	Write a blog post, article, or page targeting specific queries
`update_content`	Improve existing content to better answer AI queries
`outreach`	Reach out to sources that AI platforms cite
`technical`	Technical SEO or structured data improvements

Workflow

Call get_visibility_actions with status: "pending" and priority: "high" to find the most impactful tasks.
Use get_brand_voice, get_factsheet, and query_knowledge to gather context for content creation.
After completing an action, call complete_action to mark it done.
Run a new scan with scan_visibility to measure the impact.

Parameters

Response

Action types

Workflow

On this page