SEOmonitor API 3.0
  1. Forecast
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
  • Organic Traffic
    • Get Daily Traffic Data by Segment
    • Get Traffic Data by Keywords
    • Get Daily Traffic Data by Segment
    • Get Traffic Data by Keywords
  • Research
    • Keyword Research
      • By Topic
        • Get Related Keywords
        • Get Topic Overview
        • Get Related Keywords
        • Get Topic Overview
      • By URL
        • Domain
          • Get URL/Domain Overview
          • Get Ranking Keywords
      • Get Keyword Data
      • Get Ranking Data
      • Get Keyword Data
      • Get Ranking Data
    • Keyword Vault
      • Get Keyword Data by List
      • Get Overview Data
      • Get Keyword Data by List
      • Get Overview Data
  • Forecast
    • Get Forecast scenarios
      GET
    • Get Forecast scenario Data
      GET
    • Get Forecast objective Data
      GET
    • Get Forecast keywords
      GET
    • Get Forecast scenarios
      GET
    • Get Forecast scenario Data
      GET
    • Get Forecast objective Data
      GET
    • Get Forecast keywords
      GET
  • AI Writer
    • Generate Outlines and Articles
    • Get Generation Status
    • Get Article Content
    • Get Topic Recommendations
  • Get URL/Domain Overview
    GET
  • Get Ranking Keywords
    GET
  1. Forecast

Get Forecast objective Data

GET
/forecast/v3.0/objective
This endpoint returns the data of Forecast Scenarios set as Objectives, including the SEO goal and configuration parameters, the forecast results overview data, and the monthly actual and estimated results for the forecast timeframe.

Request

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

Header 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/forecast/v3.0/objective?campaign_id={{campaign_id}}&forecast_id=231' \
--header 'Accept: application/json' \
--header 'Authorization: <api-key>'

Responses

🟢200OK
application/json
Body

Example
{ 
    "objective_data": {
        "completion_date": "Oct 2025",
        "completion_status": {
            "30days": {
                "actual_sessions": 89500,
                "forecasted_sessions": 89500
            },
            "start_to_date": {
                "actual_sessions": 610000,
                "forecasted_sessions": 600000
            }
        }
    },
    "seo_goal": {
        "keywords_count": 882,
        "search_data": {
            "search_volume": 8700,
            "year_over_year": 1.49,
            "monthly_searches": [
               {
                   "month": "January",
                   "year": 2023,
                   "search_volume": 6700
               }
            ],
            "volume_by_device": {
                "percentage_desktop": 0.84,
                "percentage_mobile": 0.16
            },
            "percentage_clicks": 0.78
        },
        "target": {
            "average_rank": {
                "initial_rank": 18,
                "trend_3months": 5,
                "target_rank": 5,
                "best_target_rank": 2
            },
            "average_visibility": {
                "initial_visibility": 0.14,
                "trend_3months": 0.01,
                "target_visibility": 0.34,
                "best_target_visibility": 057
            }
        },
        "goal_chance": "realistic"
    },
    "scenario_configuration": {
        "timeframe": "12 mo",
        "start_month": "Oct 2023",
        "extended_forecast": true,
        "target_rank_range": false,
        "progression_speed": "conservative",
        "use_year_over_year": true,
        "use_search_volume_by_device": true,
        "use_long_tail_effect": true,
        "use_percentage_clicks": true,
        "conversion_data": {
            "conversion_rate": 0.035,
            "avg_order_value": 0.5
        }
    },
    "overview_data": {
        "additional_traffic": {
            "sessions": 900,
            "sessions_best_target": 90,
            "conversions": 2100,
            "conversions_best_target": 200,
            "revenue": 78,
            "revenue_best_target": 90
        },
        "inertial_traffic": {
            "sessions": 15800000,
            "conversions": 433000,
            "revenue": 56000
        },
        "ads_equivalent": {
            "equivalent": 68600,
            "equivalent_best_target": 6700
        }
    },
    "monthly_forecast": {
        "month": "Oct 2023",
        "seasonality": 1.83,
        "traffic_data": {
            "sessions": {
                "inertial": 859000,
                "additional": 689,
                "additional_best_target": 90
            },
            "conversions": {
                "inertial": 23500,
                "additional": 500,
                "additional_best_target": 80
            }, 
            "revenue": {
                "inertial": 278500,
                "additional": 2100,
                "additional_best_target": 80
            },
            "visibility": {
                "estimated": 0.07,
                "estimated_best_target": 0
            },
            "estimated_avg_ranks": {
                "estimated": 0.07,
                "estimated_best_target": 0
            }
        }
    },
    "monthly_forecast_extended": {
        "month": "Oct 2023",
        "seasonality": 1.83,
        "traffic_data": {
            "sessions": {
                "actual": 859000,
                "additional": 689,
                "additional_best_target": 90
            },
            "conversions": {
                "actual": 23500,
                "additional": 500,
                "additional_best_target": 80
            }, 
            "revenue": {
                "actual": 278500,
                "additional": 2100,
                "additional_best_target": 80
            }
        }
    }
}
Modified at 2025-10-28 08:15:15
Previous
Get Forecast scenario Data
Next
Get Forecast keywords
Built with