Get Forecast objective Data
GEThttps://apigw.seomonitor.com/v3/forecast/v3.0/objectiveThis 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
(Required) This parameter specifies the ID of the campaign for which you want to return data.
Please refer to the Quick Start Guide to learn how to retrieve the IDs of your campaigns.
(Required) This parameter specifies the ID of the Forecast scenario for which you want to return data.
Please refer to the Quick Start Guide to learn how to retrieve the IDs of your Forecast scenarios.
Request samples
Responses
Parent field containing the Objective completion date, and the completion status.
The month and year when the Objective has been or will be completed.
Parent field containing data related to the Objective completion status for the last 30 days and from the start of the forecast to the current date.
Parent field containing data for the SEO goal parameters. In the platform, these parameters are defined in the scenario setup through the wizard or in the scenario sidebar.
The total number of keywords included in the Objective.
Parent field containing the data related to the average Google search volumes of the keywords included in the Objective.
Parent field containing the SEO target data for the keywords included in the Objective.
The chance of achieving the target ranks considering the average Difficulty of the keywords weighted by Additional Sessions, the average Target Rank and the Initial Rank, and the configured Progression Speed. Possible values are 'realistic', 'ambitious', or 'too ambitious'.
Parent field containing data related to the parameters configured for the forecast algorithm.
The duration of the scenario in months.
The month and year when the scenario was set to start.
Whether the projection includes the extended forecast timeframe and the results estimated for it.
Whether the target rank range option is enabled for the Objective. If 'true', the estimated results of the forecast will be returned for both the lower (worst) and the higher (best) target.
The user-configured speed at which the average selected target rank will be reached. Possible values are 'conservative', 'mostly conservative', 'moderate', 'mostly moderate', 'optimistic', 'mostly optimistic', and 'custom'.
Whether the option to include the Year-over-Year search trends of the keywords in the forecast calculation is enabled.
Whether the option to include the search volume for each device of the keywords in the forecast calculation is enabled.
Whether the option to include the estimation of additional traffic generated by other keywords semantically related to the ones included in the forecast is enabled.
Whether the option to include the Percentage Clicks metric in the forecast calculation is enabled.
Parent field containing data related to the Conversion Rate and the Average Order Value that are used to calculate the Additional Conversions and Additional Revenue estimated to be obtained throughout the Forecast.
Parent field containing the estimated Additional Non-Brand Organic Traffic that would be achieved throughout the forecast timeframe.
Parent field containing the estimated Additional Non-Brand Organic Traffic that would be achieved throughout the forecast timeframe.
Parent field containing the estimated Inertial Non-Brand Organic Traffic that would be achieved throughout the forecast timeframe if the ranks remained the same as the current ranks.
Parent field containing the Ads Equivalent budget.
Parent field containing the forecast data for each month of the timeframe, including traffic, Visibility, average ranks, and search seasonality.
The month and year in the forecast timeframe for which data is returned.
The average search seasonality of the keywords included in the forecast scenario for the specific month of the timeframe. The value is returned as a percentage related to the 12-month seasonality average, where 1.00 represents the average value.
Parent field containing the data for the non-brand organic sessions, conversions, and revenue for the specific month of the timeframe.
Parent field containing the forecast data for each month of the following equal timeframe (extended forecast), including traffic data and search seasonality.
The month and year in the forecast timeframe for which data is returned.
The average search seasonality of the keywords included in the forecast scenario for the specific month of the timeframe. The value is returned as a percentage related to the 12-month seasonality average, where 1.00 represents the average value.
Parent field containing the data for the non-brand organic sessions, conversions, and revenue for the specific month of the timeframe.
{
"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
}
}
}
}