agentseo-dev Ai Visibility API
The Ai Visibility API from agentseo-dev — 1 operation(s) for ai visibility.
The Ai Visibility API from agentseo-dev — 1 operation(s) for ai visibility.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/agentseo-dev:agentseo-dev-ai-visibility-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: AgentSEO Ai Visibility API
version: 0.1.0
description: API for agent-ready SEO data extraction, analysis, and async job processing.
servers:
- url: https://www.agentseo.dev/api/v1
description: Production
- url: http://localhost:3000/api/v1
description: Local
security:
- ApiKeyAuth: []
tags:
- name: Ai Visibility
paths:
/ai-visibility/prompt-set:
post:
summary: AI visibility prompt-set builder
description: Build a stable AI visibility prompt set mapped to platforms, competitors, owned assets, citations, and weekly action routing. Costs 2 credits and does not run live LLM queries or call a paid search API.
parameters:
- $ref: '#/components/parameters/SyncParam'
- $ref: '#/components/parameters/ProjectIdHeader'
- $ref: '#/components/parameters/WorkflowIdHeader'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AiVisibilityPromptSetParams'
responses:
'200':
description: Completed AI visibility prompt-set workflow with agent_workflow
content:
application/json:
schema:
$ref: '#/components/schemas/AiVisibilityPromptSetResponse'
'202':
description: Job queued or still processing
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/QueuedJobResponse'
- $ref: '#/components/schemas/SyncPendingResponse'
- $ref: '#/components/schemas/JobStatusEnvelope'
tags:
- Ai Visibility
operationId: postAiVisibilityPromptSet
x-operation-id-source: derived
components:
schemas:
JobStatusEnvelope:
type: object
properties:
jobId:
type: string
status:
type: string
enum:
- queued
- processing
- retrying
- completed
- failed
phase:
type: string
enum:
- queued
- submitting_analysis
- waiting_analysis
- transforming
- finalizing
progress:
type: object
properties:
percent:
type: number
indeterminate:
type: boolean
eta_seconds:
type: integer
nullable: true
attempt:
type: integer
max_attempts:
type: integer
message:
type: string
created_at:
type: string
format: date-time
nullable: true
updated_at:
type: string
format: date-time
nullable: true
result:
nullable: true
error:
type: object
nullable: true
properties:
code:
type: string
message:
type: string
retryable:
type: boolean
context:
allOf:
- $ref: '#/components/schemas/JobContext'
nullable: true
poll_url:
type: string
events_url:
type: string
retry_after_seconds:
type: integer
AgentWorkflowAction:
type: object
properties:
priority:
type: string
enum:
- critical
- high
- medium
- low
action:
type: string
why:
type: string
QueuedJobResponse:
type: object
properties:
jobId:
type: string
status:
type: string
enum:
- queued
- processing
- retrying
- completed
- failed
message:
type: string
poll_url:
type: string
events_url:
type: string
retry_after_seconds:
type: integer
SyncPendingResponse:
type: object
properties:
jobId:
type: string
status:
type: string
enum:
- pending
- processing
poll_url:
type: string
events_url:
type: string
retry_after_seconds:
type: integer
JobContext:
type: object
properties:
project_id:
type: string
nullable: true
workflow_id:
type: string
nullable: true
AiVisibilityPromptSetParams:
type: object
required:
- target
- category
- topics
properties:
target:
type: string
minLength: 1
category:
type: string
minLength: 1
maxLength: 160
audience:
type: string
maxLength: 180
locale:
type: string
default: United States
platforms:
type: array
minItems: 1
maxItems: 6
items:
type: string
enum:
- chatgpt
- perplexity
- google_ai
- gemini
- copilot
- claude
default:
- chatgpt
- perplexity
- google_ai
competitors:
type: array
maxItems: 20
items:
type: string
default: []
topics:
type: array
minItems: 1
maxItems: 40
items:
type: string
maxLength: 120
product_terms:
type: array
maxItems: 40
items:
type: string
default: []
personas:
type: array
maxItems: 20
items:
type: string
default: []
owned_assets:
type: array
maxItems: 100
items:
type: object
required:
- url
- title
properties:
url:
type: string
format: uri
title:
type: string
maxLength: 180
page_type:
type: string
enum:
- homepage
- docs
- blog_post
- comparison
- pricing
- product
- case_study
- tool
- other
default: other
topics:
type: array
maxItems: 20
items:
type: string
default: []
prompt_count:
type: integer
minimum: 6
maximum: 50
default: 20
cadence:
type: string
enum:
- weekly
- biweekly
- monthly
default: weekly
include_citation_checks:
type: boolean
default: true
include_competitor_checks:
type: boolean
default: true
AiVisibilityPromptSetResponse:
type: object
properties:
target:
type: string
ai_visibility_prompt_set:
type: object
additionalProperties: true
agent_workflow:
$ref: '#/components/schemas/AgentWorkflow'
markdown_summary:
type: string
AgentWorkflowNextCall:
type: object
properties:
endpoint:
type: string
reason:
type: string
AgentWorkflow:
type: object
properties:
summary:
type: string
decision:
type: string
enum:
- ready
- act_now
- monitor
- blocker
confidence:
type: number
minimum: 0
maximum: 1
recommended_actions:
type: array
items:
$ref: '#/components/schemas/AgentWorkflowAction'
evidence:
type: array
items:
$ref: '#/components/schemas/AgentWorkflowEvidence'
limitations:
type: array
items:
type: string
next_calls:
type: array
items:
$ref: '#/components/schemas/AgentWorkflowNextCall'
AgentWorkflowEvidence:
type: object
properties:
finding:
type: string
detail:
type: string
severity:
type: string
enum:
- critical
- high
- medium
- low
parameters:
SyncParam:
name: sync
in: query
required: false
schema:
type: boolean
default: false
description: Open a short inline processing window when supported by the endpoint. If the result is not ready yet, the endpoint may still return 202 with a queued payload that includes poll_url, events_url, and retry_after_seconds.
WorkflowIdHeader:
name: x-workflow-id
in: header
required: false
schema:
type: string
maxLength: 120
description: Optional attribution label for grouping usage and jobs by workflow or agent run.
ProjectIdHeader:
name: x-project-id
in: header
required: false
schema:
type: string
maxLength: 120
description: Optional attribution label for grouping usage and jobs by project.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key