Articles

Poll an article generation

Status of an article. status walks generating → qa → ready (or failed); published appears when the operator publishes it later. Content fields (title, meta_description, content_markdown, word_count, qa_score, language) appear only once the article is ready or published — while generating you get status only. Sandbox articles carry a watermark object and are never published automatically.

get/v1/articles/{articleId}

Request

  • Base URL: https://serp-agent.com
  • URL: https://serp-agent.com/v1/articles/{articleId}
  • Auth: HTTP bearer

Path parameters

articleIdstring required

Article id from POST /v1/projects/{projectId}/articles.

Response

Current article state.

article_idstring required
project_idstring required
status'generating' | 'qa' | 'ready' | 'published' | 'failed' required

generating → qa → ready. "published" if/when the operator publishes it. Content fields appear at ready/published.

titlestring nullable
meta_descriptionstring nullable
content_markdownstring nullable

Full article body as markdown.

word_countinteger nullable
qa_scoreinteger nullable

Internal QA score 0–100.

languagestring
errorstring

Present only when failed.

Changes

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