GEO/AEO

Run Visibility Scan

Run a full visibility scan across multiple prompts and AI models.

Returns a comprehensive visibility report with scores, recommendations, and areas for improvement.

If save_to_library=True, prompts are saved to the target_prompts table with their visibility scores.

post/api/geo-aeo/run-scan

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/run-scan
  • Auth: HTTP bearer

Request body

promptsobject[] required

Prompts to test

modelsstring[] nullable

Models to test (chatgpt, claude, gemini, grok)

brand_namesstring[] required

Brand names to look for in responses

save_to_libraryboolean

Save prompts to the topic library after scanning

default_topicstring

Topic name for saved prompts

Response

Successful Response

brand_namestring required
total_prompts_testedinteger required
overall_visibility_scorenumber required
model_breakdownobject required
top_performing_promptsobject[] required
needs_improvementobject[] required
content_recommendationsstring[] required
generated_atstring required

Changes

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