How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Voyant.io GEO/AEO API

Generative Engine Optimization - monitor your visibility in AI search engines (ChatGPT, Claude, Perplexity).

Voyant.io GEO/AEO API is one of 99 APIs that Voyant.io publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include GEO/AEO. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

This API exposes 49 operations across 44 paths, and defines 24 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://voice-forge-production.up.railway.app.

49 operations 44 paths 24 schemas 3 DELETE21 GET2 PATCH23 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://voice-forge-production.up.railway.app
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Voyant.io GEO/AEO API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (HTTPBearer).

Paths & Operations 49

Across 44 paths, the API surfaces 49 operations — 3 DELETE, 21 GET, 2 PATCH, 23 POST. Each is listed below with its method, path, parameters, and response codes.

GEO/AEO 49

Generative Engine Optimization - monitor your visibility in AI search engines (ChatGPT, Claude, Perplexity).

POST
/api/geo-aeo/generate-prompts
Generate Prompts
generate_prompts_api_geo_aeo_generate_prompts_post body → 200422
POST
/api/geo-aeo/generate-prompts/stream
Generate Prompts Stream
generate_prompts_stream_api_geo_aeo_generate_prompts_stream_post body → 200422
POST
/api/geo-aeo/test-prompt
Test Single Prompt
test_single_prompt_api_geo_aeo_test_prompt_post body → 200422
POST
/api/geo-aeo/run-scan
Run Visibility Scan
run_visibility_scan_api_geo_aeo_run_scan_post body → 200422
POST
/api/geo-aeo/run-scan/stream
Run Visibility Scan Stream
run_visibility_scan_stream_api_geo_aeo_run_scan_stream_post body → 200422
GET
/api/geo-aeo/models
Get Available Models
get_available_models_api_geo_aeo_models_get → 200
GET
/api/geo-aeo/prompt-categories
Get Prompt Categories
get_prompt_categories_api_geo_aeo_prompt_categories_get → 200
GET
/api/geo-aeo/sessions
Get Session Status
get_session_status_api_geo_aeo_sessions_get → 200
POST
/api/geo-aeo/sessions/{platform}
Save Session
save_session_api_geo_aeo_sessions__platform__post 1 param body → 200422
GET
/api/geo-aeo/query-mode
Get Query Mode
get_query_mode_api_geo_aeo_query_mode_get → 200
POST
/api/geo-aeo/query-mode/{mode}
Set Query Mode
set_query_mode_api_geo_aeo_query_mode__mode__post 1 param → 200422
GET
/api/geo-aeo/prompts
List Prompts
list_prompts_api_geo_aeo_prompts_get 5 params → 200422
POST
/api/geo-aeo/prompts
Create Prompt
create_prompt_api_geo_aeo_prompts_post body → 200422
POST
/api/geo-aeo/prompts/bulk
Bulk Create Prompts
bulk_create_prompts_api_geo_aeo_prompts_bulk_post body → 200422
PATCH
/api/geo-aeo/prompts/{prompt_id}
Update Prompt
update_prompt_api_geo_aeo_prompts__prompt_id__patch 1 param body → 200422
DELETE
/api/geo-aeo/prompts/{prompt_id}
Delete Prompt
delete_prompt_api_geo_aeo_prompts__prompt_id__delete 1 param → 200422
GET
/api/geo-aeo/topics
List Topics
list_topics_api_geo_aeo_topics_get → 200
POST
/api/geo-aeo/topics
Create Topic
create_topic_api_geo_aeo_topics_post body → 200422
DELETE
/api/geo-aeo/topics/{topic_name}
Delete Topic
delete_topic_api_geo_aeo_topics__topic_name__delete 1 param → 200422
POST
/api/geo-aeo/prompts/{prompt_id}/continuous-testing
Toggle Continuous Testing
toggle_continuous_testing_api_geo_aeo_prompts__prompt_id__continuous_testing_post 3 params → 200422
POST
/api/geo-aeo/prompts/bulk-schedule
Bulk Update Schedule
bulk_update_schedule_api_geo_aeo_prompts_bulk_schedule_post body → 200422
GET
/api/geo-aeo/prompts/continuous
Get Continuous Testing Prompts
get_continuous_testing_prompts_api_geo_aeo_prompts_continuous_get → 200
GET
/api/geo-aeo/results/latest
Get Latest Visibility Results
get_latest_visibility_results_api_geo_aeo_results_latest_get → 200
GET
/api/geo-aeo/prompts/{prompt_id}/responses
Get Prompt Responses
get_prompt_responses_api_geo_aeo_prompts__prompt_id__responses_get 1 param → 200422
POST
/api/geo-aeo/prompts/scan
Scan Saved Prompts
scan_saved_prompts_api_geo_aeo_prompts_scan_post 1 param body → 200422
POST
/api/geo-aeo/prompts/generate-and-save
Generate And Save Prompts
generate_and_save_prompts_api_geo_aeo_prompts_generate_and_save_post 1 param body → 200422
POST
/api/geo-aeo/scan/start
Start Visibility Scan
start_visibility_scan_api_geo_aeo_scan_start_post body → 200422
GET
/api/geo-aeo/scan/{job_id}/status
Get Scan Status
get_scan_status_api_geo_aeo_scan__job_id__status_get 1 param → 200422
POST
/api/geo-aeo/guidance/stream
Stream Visibility Guidance
stream_visibility_guidance_api_geo_aeo_guidance_stream_post body → 200422
POST
/api/geo-aeo/content-topics
Save Content Topic
save_content_topic_api_geo_aeo_content_topics_post body → 200422
GET
/api/geo-aeo/content-topics
List Content Topics
list_content_topics_api_geo_aeo_content_topics_get 3 params → 200422
POST
/api/geo-aeo/airops/sync
Sync To Airops
sync_to_airops_api_geo_aeo_airops_sync_post → 200
GET
/api/geo-aeo/airops/context
Get Context For Airops
get_context_for_airops_api_geo_aeo_airops_context_get 2 params → 200422
GET
/api/geo-aeo/airops/search
Search Airops
search_airops_api_geo_aeo_airops_search_get 3 params → 200422
GET
/api/geo-aeo/airops/export/content-topics.csv
Export Content Topics Csv
export_content_topics_csv_api_geo_aeo_airops_export_content_topics_csv_get 1 param → 200422
GET
/api/geo-aeo/airops/export/use-cases.csv
Export Use Cases Csv
export_use_cases_csv_api_geo_aeo_airops_export_use_cases_csv_get → 200
GET
/api/geo-aeo/airops/export/personas.csv
Export Personas Csv
export_personas_csv_api_geo_aeo_airops_export_personas_csv_get → 200
GET
/api/geo-aeo/airops/export/geo-prompts.csv
Export Geo Prompts Csv
export_geo_prompts_csv_api_geo_aeo_airops_export_geo_prompts_csv_get → 200
PATCH
/api/geo-aeo/content-topics/{topic_id}
Update Content Topic
update_content_topic_api_geo_aeo_content_topics__topic_id__patch 5 params → 200422
DELETE
/api/geo-aeo/content-topics/{topic_id}
Delete Content Topic
delete_content_topic_api_geo_aeo_content_topics__topic_id__delete 1 param → 200422
POST
/api/geo-aeo/content-topics/from-signals
Create Topics From Signals
create_topics_from_signals_api_geo_aeo_content_topics_from_signals_post body → 200422
POST
/api/geo-aeo/content-topics/from-competitor/{competitor_id}
Create Topics From Competitor
create_topics_from_competitor_api_geo_aeo_content_topics_from_competitor__competitor_id__post 4 params → 200422
POST
/api/geo-aeo/content-topics/from-all-competitors
Create Topics From All Competitors
create_topics_from_all_competitors_api_geo_aeo_content_topics_from_all_competitors_post 2 params → 200422
GET
/api/geo-aeo/brand-snapshots/daily
Get Daily Brand Snapshots
get_daily_brand_snapshots_api_geo_aeo_brand_snapshots_daily_get 1 param → 200422
GET
/api/geo-aeo/brand-snapshots/weekly
Get Weekly Brand Insights
get_weekly_brand_insights_api_geo_aeo_brand_snapshots_weekly_get 1 param → 200422
POST
/api/geo-aeo/brand-snapshots/run
Run Brand Snapshot
run_brand_snapshot_api_geo_aeo_brand_snapshots_run_post 2 params → 200422
POST
/api/geo-aeo/baseline-probe/run
Run Baseline Probe
run_baseline_probe_api_geo_aeo_baseline_probe_run_post body → 200422
GET
/api/geo-aeo/baseline-probe/history
Get Baseline Probe History
get_baseline_probe_history_api_geo_aeo_baseline_probe_history_get 2 params → 200422
GET
/api/geo-aeo/baseline-probe/latest
Get Latest Baseline Probe
get_latest_baseline_probe_api_geo_aeo_baseline_probe_latest_get 1 param → 200422

Schemas 24

The contract defines 24 schemas that model the data the API accepts and returns. The most detailed are TargetPromptResponse (14 properties), ContentTopicResponse (12 properties), SaveContentTopicRequest (9 properties), GeneratePromptsRequest (8 properties). Each schema is shown below with its type and property counts.

TestPromptsRequest
object
Request to test prompts for visibility.
5 properties 2 required
SinglePromptTestRequest
object
Request to test a single prompt.
3 properties 2 required
TopicCreate
object
Create a new topic.
3 properties 1 required
ContentTopicResponse
object
Response for a content topic.
12 properties 8 required
Body_scan_saved_prompts_api_geo_aeo_prompts_scan_post
object
3 properties
TargetPromptCreate
object
Create a new target prompt.
7 properties 2 required
ValidationError
object
5 properties 3 required
SaveSessionRequest
object
Request to save session cookies for an AI platform.
2 properties 2 required
VisibilityReportResponse
object
Full visibility report response.
8 properties 8 required
TopicResponse
object
Response for a topic.
5 properties 5 required
PromptResponse
object
Response with generated prompts.
2 properties 2 required
CreateTopicsFromSignalsRequest
object
Request to create content topics from signals.
2 properties 1 required
ScanJobResponse
object
Response when starting an async scan job.
3 properties 3 required
BulkScheduleRequest
object
Bulk update scheduling for multiple prompts.
3 properties 2 required
TargetPromptUpdate
object
Update a target prompt.
6 properties
VisibilityResultResponse
object
Response for a single prompt visibility test.
6 properties 6 required
TargetPromptResponse
object
Response for a target prompt.
14 properties 12 required
BaselineProbeRequest
object
Request to run a baseline probe.
2 properties
BulkPromptCreate
object
Bulk create prompts.
1 property 1 required
HTTPValidationError
object
1 property
GuidanceRequest
object
Request for visibility gap guidance.
6 properties 3 required
SaveContentTopicRequest
object
Request to save a visibility gap as a content topic.
9 properties 1 required
GeneratePromptsRequest
object
Request to generate GEO prompts from context.
8 properties 1 required
StartScanRequest
object
Request to start an async visibility scan.
3 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

voyant-geo-aeo-api-openapi.yml Raw ↑

Other APIs Voyant.io publishes across the network.

Voyant MCP Server
Voyant.io Admin API
Voyant.io Admin Migration API
Voyant.io AI Assistant API
Voyant.io Airops API
Voyant.io Analytics API
Voyant.io API Keys API
Voyant.io Attribution API
Voyant.io Attribution Intelligence API
Voyant.io Auth API
Voyant.io Battlecards API
Voyant.io Bootstrap API
Where this information came from

This is an independent, third-party profile of Voyant.io GEO/AEO API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.