Content technical publish QA

Run pre-publish technical SEO QA for a URL, HTML page, or markdown draft. Costs 2 credits and does not call a paid SERP provider.

post/content/technical-qa

Request

  • Base URL: https://www.agentseo.dev/api/v1
  • URL: https://www.agentseo.dev/api/v1/content/technical-qa
  • Auth: API key in header x-api-key

Query parameters

syncboolean

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.

Headers

x-project-idstring

Optional attribution label for grouping usage and jobs by project.

x-workflow-idstring

Optional attribution label for grouping usage and jobs by workflow or agent run.

Request body

urlstring uri

Live page URL to fetch and inspect. Provide url, html, or markdown.

htmlstring

Raw HTML for unpublished or staging pages.

markdownstring

Markdown draft when HTML is not available.

keywordstring

Optional target keyword for title alignment checks.

targetstring

Optional target brand, domain, or product.

expected_canonicalstring uri

Expected canonical URL. Mismatches are high severity.

page_type'auto' | 'article' | 'blog_post' | 'landing_page' | 'product' | 'software' | 'local_business' | 'comparison_page' | 'guide' | 'docs'
check_external_linksboolean

Response

Completed technical publish QA workflow with agent_workflow

urlstring nullable
targetstring nullable
keywordstring nullable
technical_publish_qaobject
markdown_summarystring

Changes

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