GEO/AEO

Save Content Topic

Save a visibility gap as a content topic for the content strategist.

Creates a backlog item that content teams can review, prioritize, and schedule. Also pushes to AirOps vector store for use in content workflows.

post/api/geo-aeo/content-topics

Request

  • Base URL: https://voyant.io (the document declares no server; this is the origin it was published from)
  • URL: https://voyant.io/api/geo-aeo/content-topics
  • Auth: HTTP bearer

Request body

promptstring required

The prompt/query that revealed the gap

categorystring nullable

Prompt category

sourcestring

Source: manual, signal, geo_visibility, competitor_gap

visibility_scorenumber
brand_mentionedboolean
competitors_mentionedstring[]
ai_response_summarystring nullable

Summary of AI response

notesstring nullable

Additional notes

prioritystring

Priority: high, medium, low

prompt_idstring nullable

target_prompts id the gap came from, if known

Response

Successful Response

idstring required
promptstring required
categorystring nullable required
sourcestring nullable
visibility_scorenumber required
brand_mentionedboolean required
competitors_mentionedstring[] required
notesstring nullable
guidancestring nullable required
suggested_atstring required
statusstring nullable
prioritystring nullable
suggested_actionstring nullable
ai_response_summarystring nullable
source_urlstring nullable
source_metadataobject
narrative_idstring nullable
narrative_namestring nullable
narrative_confidencenumber nullable
signal_idstring nullable
competitor_idstring nullable
campaign_idstring nullable
content_urlstring nullable
content_published_atstring nullable
updated_atstring nullable
prompt_idstring nullable
promptsobject[]

Changes

No recorded changes to this operation across all 1 revision of this API.