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
      • Get Traffic Data by Keywords
        GET
    • 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
        • Get Lists
    • Forecast
      • Get Forecast scenarios
      • Get Forecast scenario Data
      • Get Forecast objective Data
      • Get Forecast keywords
    • AI Writer
      • Get Article Content
      • Generate Outlines and Articles
      • Get Generation Status
      • Get Topic Recommendations
    • Dashboard
      • List Companies (Accounts)
    • Get URL/Domain Overview
      GET
    • Get Ranking Keywords
      GET
    • Get Article Content
      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

      Get Article Content

      GET
      /ai-writer/v3.0/article
      Authentication required. Set the Authorization header to your SEOmonitor API token (raw JWT — no Bearer prefix). See the Authentication Guide for setup.
      Get current Article content, including Outline, AI Version, Working Draft and Live version.

      Request

      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 --globoff 'https://apigw.seomonitor.com/v3/ai-writer/v3.0/article?campaign_id={{campaign_id}}&article_id={{article_id}}'

      Responses

      🟢200Success
      application/json
      Bodyapplication/json

      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 2026-05-24 17:22:25
      Previous
      Get Ranking Keywords
      Next
      campaign-visibility-timeframes
      Built with