get_goals_and_ideas

Get content strategy goals and actionable content ideas generated from visibility scan data.

Get content strategy goals and actionable content ideas for a brand. Goals are strategic themes generated from visibility scan data. Each goal has specific content ideas (pitches) you can turn into articles, blog posts, or social content.

Ideas with usedCount: 0 haven't been written yet — prioritize those.

Authentication: Required

Parameters

Parameter	Type	Required	Description
`syntheticId`	`integer`	Yes	The agent ID to get goals and ideas for.

Response

{
  "syntheticId": 1234,
  "brandName": "Example",
  "goalCount": 3,
  "totalIdeas": 15,
  "unusedIdeas": 9,
  "goals": [
    {
      "id": "goal-1",
      "title": "Establish thought leadership in AI monitoring",
      "description": "Position Example as the go-to resource for AI visibility insights.",
      "ideaCount": 5,
      "ideas": [
        {
          "id": "idea-1",
          "pitch": "Write a data-driven guide comparing how ChatGPT, Claude, and Gemini recommend different types of SaaS tools.",
          "usedCount": 0,
          "lastUsedAt": null
        },
        {
          "id": "idea-2",
          "pitch": "Create a case study showing how a brand improved its AI mention rate by 40% in 3 months.",
          "usedCount": 1,
          "lastUsedAt": "2026-03-15T10:00:00Z"
        }
      ]
    }
  ]
}

Key fields

Field	Description
`goalCount`	Number of strategic content goals
`totalIdeas`	Total content ideas across all goals
`unusedIdeas`	Ideas with `usedCount: 0` — fresh pitches to write
`ideas[].pitch`	The content idea as a natural-language pitch
`ideas[].usedCount`	How many times this idea has been used to create content

Parameters

Response

Key fields

On this page