SEOmonitor API 3.0
  1. AI Writer
SEOmonitor API 3.0
  • Overview
  • Campaigns
    • Get Tracked Campaigns
      GET
  • Rank Tracker
    • Get Keyword Data
      GET
    • Get Keyword AI Overview Data
      GET
    • Get Keyword AI Search Data
      GET
    • Get Groups List
      GET
    • Get Keywords Competition Data
      GET
    • Get Keywords Competition Data AI Overview
      GET
    • Get Keywords Competition AI Search Data
      GET
    • Get Top 100 Results
      GET
    • Get Groups Data
      GET
    • Get Daily Keyword Ranks
      GET
    • Get Daily Keyword Ranks AI Overview
      GET
    • Get Daily AI Search Keyword Ranks
      GET
    • Get Daily Group Visibility
      GET
    • Get Daily Group Visibility AI Overview Mentions
      GET
    • Get Daily Group Visibility AI Overview Citations
      GET
    • Add New Keywords
      POST
    • Get Keywords Import Status
      GET
    • Get Daily SERP Feature Presence
      GET
    • Get Ranking Pages
      GET
    • Get Daily Share of Clicks
      GET
    • Get Share of Voice
      GET
    • Get Daily Group AI Search Brand Mentions visibility
      GET
    • Get Daily Group AI Search Site Citations visibility
      GET
    • Get SERP Visibility Data
      GET
  • Organic Traffic
    • Get Daily Traffic Data by Segment
    • Get Traffic Data by Keywords
  • Research
    • Keyword Research
      • By Topic
        • Get Related Keywords
        • Get Topic Overview
      • By URL
        • Domain
          • Get URL/Domain Overview
          • Get Ranking Keywords
      • Get Keyword Data
      • Get Ranking Data
    • Keyword Vault
      • Get Keyword Data by List
      • Get Overview Data
  • Forecast
    • Get Forecast scenarios
    • Get Forecast scenario Data
    • Get Forecast objective Data
    • Get Forecast keywords
  • AI Writer
    • Generate Outlines and Articles
      POST
    • Get Generation Status
      GET
    • Get Article Content
      GET
    • Get Topic Recommendations
      GET
  • Get URL/Domain Overview
    GET
  • Get Ranking Keywords
    GET
  • Schemas
    • Schemas
      • Root Type for campaign-visibility-timeframes
      • Root Type for campaign-details-regular
      • Root Type for group-details
      • Root Type for group-details-visibility
      • Root Type for serp-featuers-counter
      • Root Type for keyword-detail
      • Root Type for keyword-ranking-data
      • Root Type for keyword-rank-trend
      • Root Type for keyword-traffic-data
      • Root Type for keyword-landing-pages
      • Root Type for keyword-canibalization-on-date
      • Root Type for topic-keyword-detail
      • Root Type for content-landing-page-issue
      • Root Type for content_changes
      • Root Type for traffic-keywords
      • Traffic Unallocated
      • Root Type for traffic-overview
      • Root Type for campaign-visibility
      • Root Type for groups-search-data
      • Root Type for groups-serp-data
      • Root Type for groups-traffic-data
      • Root Type for keyword-daily-ranks
      • Root Type for keyword-daily-ranks-mobile-desktop
      • Root Type for daily-visibility
      • Root Type for ranking-pages
      • Root Type for analytics-data
      • Root Type for website-explorer-keywords
      • Root Type for research-serp-data
      • Root Type for research-search-data
      • Root Type for Website-explorer-overview
      • Root Type for Topics-explorer-overview
      • Root Type for research-domain-overview
      • Root Type for domain-overview-traffic
      • Root Type for domain-overview-visibility
      • Root Type for domain-rankings-data
      • Root Type for domain-ranking-keywords-data
      • Root Type for keyword-vault-get-overview-data
      • keyword-vault-get-keyword-data-by-list
      • Root Type for forecast-keyworfs
      • Root Type for forecast-scenario-data
      • Root Type for forecast-seo-goal
      • Root Type for forecast-scenario-search-data
      • Root Type for forecast-target-data
      • Root Type for forecast-configuration
      • Root Type for forecast-overview-data
      • Root Type for monthly-forecast
      • Root Type for monthly-forecast-traffic
      • Root Type for daily-share-of-clicks
      • Root Type for forecast-scenario-data
      • Root Type for forecast-objective-details
      • Root Type for objective-completion-status
      • Root Type for visibility-desktop-mobile
      • Root Type for group
      • Root Type for groups-details-keywords-counters
      • Root Type for searches-percentages-by-device
      • Root Type for opportunity
      • Root Type for keyword-traffic-ecommerce
      • Root Type for keyword-traffic-goals
      • Root Type for keyword-serp-feature
      • Root Type for keyword-canibalization-rank-data
      • Root Type for keyword-canibalization-landing-page-change
      • Root Type for keyword-competition
      • Root Type for keyword-serp-result
      • Root Type for keyword-competitor-ranking-data
      • Root Type for keywords-import-status
      • Root Type for add-keywords
      • Root Type for domain-visibility
      • Root Type for add-campaign-post-biody
      • Root Type for keywords-import-post-body
      • campaign-info
      • Root Type for keywords-import-post-body
      • Root Type for Website-explorer-keyword-domain
      • Root Type for objective
      • Root Type for search-data
      • Root Type for difficulty-value
      • Root Type for content_change
      • Ecommerce
      • Goals
      • Traffic Ecommerce
      • Traffic Goals
      • Root Type for keyword-serp-feaftures
      • Root Type for sesonality-trend
      • Root Type for best_rank
      • Root Type for landing-pages
      • Root Type for top-results
      • Root Type for top-100-results
      • Root Type for group_keyword_counters
      • groups-opportunity
      • Root Type for groups-volume-by-device
      • Root Type for groups-search-intent
      • Root Type for groups-desktop-mobile-visibility
      • Root Type for groups-mobile-visibility
      • Root Type for groups-serp-mobile-desktop
      • Root Type for keyword-daily-rank
      • Root Type for groups-visibility
      • Root Type for groups-avg-rank
      • Root Type for groups-feature-visibility
      • Root Type for ranking-keywords
      • Root Type for serp-feature-presence
      • Root Type for serp-feature-presence-by-device
      • Root Type for serp-feature-presence-mobile-desktop
      • Root Type for gsc-data
      • Root Type for research-ranking-data
      • Root Type for research-serp-feature
      • Root Type for research-domain-ranking
      • Root Type for topic-overview-serp
      • Root Type for topic-overview-serp-feature
      • Root Type for topic-overview-visibility
      • Root Type for overview-traffic-data
      • Root Type for domain-competitor-visibility
      • Root Type for domain-competitor-rank
      • Root Type for forecast-keyword-data
      • Root Type for forecast-keyword-avg-rank
      • Root Type for forecast-keyword-additional-traffic
      • Root Type for forecast-target-avg-rank
      • Root Type for forecast-target-avg-visibility
      • Root Type for forecast-config-conversion-data
      • Root Type for forecast-additional-traffic
      • Root Type for forecast-overview-inertial-traffic
      • Root Type for forecast-ads-equivalent
      • Root Type for forecast-
      • Root Type for forecast-traffic-revenue
      • Root Type for forecast-traffic-visibility
      • Root Type for forecast-traffic-estimated_avg_ranks
      • Root Type for Scenarios
      • Root Type for monthly-forecast-traffic-sessions
      • Root Type for share-of-clicks-domains
      • Root Type for completion-status-30days
      • Root Type for completion-status-date-sessions
    • RequestBodies
      • Body
    • SerpVisibilityResponse
    • SerpVisibilityDataItem
    • SerpVisibilityMeta
    • ErrorResponse
  1. AI Writer

Get Article Content

GET
ai-writer/v3.0/article
Get current Article content, including Outline, AI Version, Working Draft and Live version.

Request

Authorization
API Key
Add parameter in header
Authorization
Example:
Authorization: ********************
or
Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://apigw.seomonitor.com/v3ai-writer/v3.0/article?campaign_id={{campaign_id}}&article_id={{article_id}}' \
--header 'Authorization: <api-key>'

Responses

🟢200Success
application/json
Body

Example
{
  "article_id": 35743,
  "topic": "The Future of SEO in 2026",
  "potential_traffic": 3600,
  "percentage_of_clicks": 0.9,
  "top10_competitors": [
    {
      "url": "https://another-website.com/case-study",
      "rank": 3,
      "wordcount": 2600
    },
    {
      "url": "https://and-another-website.com/case-study",
      "rank": 5,
      "wordcount": 2600
    }
  ],
  "article_type": "comprehensive",
  "status": "article_generated",
  "seo_score": {
    "overall": 90,
    "title": 77,
    "headings": 88,
    "coverage": 93,
    "wordcount": 96,
    "images": 100,
    "uniqueness": 100
  },
  "keywords": {
    "title": [
      {
        "keyword": "seo tutorial",
        "volume": 12500,
        "status": "included"
      },
      {
        "keyword": "learn seo",
        "volume": 3600,
        "status": "included"
      }
    ],
    "headings_and_coverage": [
      {
        "keyword": "seo tutorial",
        "volume": 3600,
        "status": "included"
      },
      {
        "keyword": "learn seo",
        "volume": 22000,
        "status": "not_included_in_headings"
      }
    ]
  },
  "quality_check": {
    "general_assessment": "The article demonstrates strong adherence to SEO best practices and content structure guidelines...",
    "content_foundation": [
      {
        "name": "Introduction",
        "score": 90,
        "description": "..."
      },
      {
        "name": "Conclusion",
        "score": 85,
        "description": "..."
      }
    ],
    "technical_elements": [
      {
        "name": "Links Inclusion",
        "score": 100,
        "description": "..."
      }
    ],
    "content_quality": [
      {
        "name": "Uniqueness",
        "score": 85,
        "description": "..."
      }
    ]
  },
  "fact_check": [
    {
      "statement": "Keep them between 150-160 characters",
      "methodology": "I searched for 'meta description character limit SEO' and 'meta description length SEO' to find current recommendations and Google's guidelines.",
      "findings": [
        "stanventures.com - Google does not provide an official character limit for meta descriptions, but rather considers the number of pixels used.",
        "yoast.com - Google generally displays meta descriptions up to about 155 characters in the SERPs, and anything longer may be truncated."
      ],
      "conclusion": "Google does not enforce a strict character limit for meta descriptions, but for optimal display in search results, it is generally recommended to keep them between 150 and 160 characters (or around 920 pixels) to avoid truncation."
    }
  ],
  "outline": "<h1>Introduction: The Shifting SEO Landscape...</p>",
  "ai_version": "<h1>Introduction: The Shifting SEO Landscape</h1><p>The world of SEO is in constant flux...</p>",
  "ai_generation_settings": {
    "use_campaign_settings": true,
    "writing_style": "Write this article in a colocvial style",
    "campaing_settings_prompt": "Do not use any of our competitor's brands in the generated content",
    "article_type": "comprehensive",
    "market": "US",
    "own_content_url": "https://yourblog.com/ai-marketing-2024",
    "own_content_prompt": "Use the provided URL as inspiration for tone and structure, but update all data and predictions for 2026 and beyond.",
    "web_research_topic": "latest advancements in generative AI for marketing automation",
    "web_research_prompt": "Integrate the findings from the web research into a dedicated section about emerging technologies.",
    "discovery_links": true,
    "custom_links": [
      {
        "url": "https://partner-website.com/case-study"
      }
    ],
    "internal_links": [
      {
        "url": "https://yourblog.com/internal-page"
      }
    ],
    "generate_references": true,
    "custom_guidelines": "The article must include a list of 5 actionable tips for CMOs. The conclusion should summarize the key trends.",
    "generate_images": true
  },
  "working_draft": "<h1>The Evolving SEO Landscape</h1><p>The world of search engine optimization is in constant flux...</p>",
  "live_version_html": null,
  "content_html": "<h1>The Evolving SEO Landscape</h1><p>The world of search engine optimization is in constant flux...</p>",
  "last_edit_date": "2025-09-03T18:00:00Z"
}
🟠400Bad Request
🟠401Unauthorized
🔴500Server Error
Modified at 2025-11-03 10:02:15
Previous
Get Generation Status
Next
Get Topic Recommendations
Built with