---
title: "Page CRO and CTA QA"
method: POST
path: "/page/cro-qa"
---

# Page CRO and CTA QA

`POST /page/cro-qa`

## Request

- Base URL: `https://www.agentseo.dev/api/v1`
- URL: `https://www.agentseo.dev/api/v1/page/cro-qa`
- Auth: API key in header `x-api-key`

Audit an SEO landing page for value proposition clarity, CTA strength, trust proof, objection handling, and conversion friction. Costs 2 credits and does not call a paid search API.

## Query parameters

- `sync` boolean

## Headers

- `x-project-id` string
- `x-workflow-id` string

## Request body

- PageCroQaParams: Provide url, html, or markdown.
  - `url` string, uri
  - `html` string
  - `markdown` string
  - `target` string: Optional target brand, domain, or product.
  - `keyword` string: Optional target keyword for hero/intent alignment checks.
  - `page_type` 'auto' | 'homepage' | 'landing_page' | 'pricing' | 'feature' | 'blog_post' | 'product' | 'comparison_page' | 'docs'
  - `conversion_goal` 'signup' | 'trial' | 'demo' | 'purchase' | 'contact_sales' | 'subscribe' | 'download' | 'learn_more'
  - `traffic_source` 'organic' | 'paid' | 'email' | 'social' | 'direct' | 'referral' | 'unknown'
  - `audience` string

## Response `200`

Completed page CRO QA workflow with agent_workflow

- PageCroQaResponse
  - `target` string, nullable
  - `page_cro_qa` object
  - `agent_workflow` AgentWorkflow
    - `summary` string
    - `decision` 'ready' | 'act_now' | 'monitor' | 'blocker'
    - `confidence` number
    - `recommended_actions` AgentWorkflowAction[]
      - `priority` 'critical' | 'high' | 'medium' | 'low'
      - `action` string
      - `why` string
    - `evidence` AgentWorkflowEvidence[]
      - `finding` string
      - `detail` string
      - `severity` 'critical' | 'high' | 'medium' | 'low'
    - `limitations` string[]
    - `next_calls` AgentWorkflowNextCall[]
      - `endpoint` string
      - `reason` string
  - `markdown_summary` string

## Other responses

- `202`: Job queued or still processing

---

[API](https://skmtc.dev/agentseo/apis/agentseo-api.md) · [All operations](https://skmtc.dev/agentseo/apis/agentseo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentseo/apis/agentseo-api/revisions/53a62da6f92c?raw)
