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 Topic Recommendations

GET
/ai-writer/v3.0/topic-recommendations
This endpoint provides AI-powered topic recommendations for content creation, integrated with SEOmonitor's existing AI Writer API. It manages topic categories, generates strategic content suggestions with SEO metrics, and follows the same authentication and rate limiting patterns as the core AI Writer API.
Key Features:
Generate topic recommendations based on seed keywords or general categories
Maintain and retrieve topic categories for organized content planning
Provide SEO metrics including search volume, difficulty, and ranking potential
Support both general recommendations and category-specific suggestions
Integrate with existing campaign structure

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/v3/ai-writer/v3.0/topic-recommendations?campaign_id={{campaign_id}}&on_demand=false&category={{category}}&limit={{limit}}&metrics={{metrics}}&sort_by={{sort_by}}&offset={{offset}}' \
--header 'Authorization: <api-key>'

Responses

🟢200Success
application/json
Body

Example
{
  "campaign_id": 322611,
  "request_type": "topic_recommendations",
  "category_info": {
    "category_name": "marketing digital",
    "category_exists": true,
    "category_id": "cat_001",
    "created_at": "2024-01-15T10:30:00Z"
  },
  "recommendations": [
    {
      "topic": "ce face agentie digitala",
      "topic_id": "topic_001",
      "average_rank": "99+",
      "potential_traffic": "3.4K/mo",
      "keywords_count": 15,
      "clicks_percentage": 95,
      "total_volume": 3400,
      "projected_monthly_visits": 3400,
      "used": false,
      "generated_at": "2025-01-15T14:30:00Z"
    },
    {
      "topic": "avantaje publicitate online 2026",
      "topic_id": "topic_002",
      "average_rank": "99+",
      "potential_traffic": "250/mo",
      "keywords_count": 8,
      "clicks_percentage": 92,
      "total_volume": 250,
      "projected_monthly_visits": 250,
      "used": false,
      "generated_at": "2025-01-15T14:30:00Z"
    },
    {
      "topic": "agentie marketing digital preturi",
      "topic_id": "topic_003",
      "average_rank": "99+",
      "potential_traffic": "200/mo",
      "keywords_count": 12,
      "clicks_percentage": 88,
      "total_volume": 200,
      "projected_monthly_visits": 200,
      "used": false,
      "generated_at": "2025-01-15T14:30:00Z"
    }
  ],
  "metadata": {
    "total_recommendations": 3,
    "unused_topics_count": 3,
    "category_topics_count": 25,
    "generation_method": "ai_generated",
    "last_updated": "2025-01-15T14:30:00Z"
  }
}
🟠400Bad Request
🟠401Unauthorized
🔴500Server Error
Modified at 2025-11-02 09:31:32
Previous
Get Article Content
Next
Get URL/Domain Overview
Built with