Get Forecast scenario Data
/forecast/v3.0/scenario
This endpoint returns the data of Forecast Scenarios created in a specified campaign, including the scenario details, the SEO goal and configuration parameters, the forecast results overview data, and the monthly estimated results for the forecast timeframe.
Request
Query Params
campaign_id
string
required
(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.
Example:
{{campaign_id}}
forecast_id
string
required
(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.
To get data for the Campaign Objective, use the 'Get Forecast Objective Data'.
Example:
183
Header Params
Accept
string
required
Example:
application/json
Request samples
Responses
Success(200)
HTTP Code: 200
Content Type : JSON
Data Schema
seo_goal
object {4}
required
keywords_count
string
required
search_data
object {4}
required
target
object {2}
required
goal_chance
string
required
scenario_configuration
object {10}
required
timeframe
string
required
start_month
string
required
extended_forecast
string
required
target_rank_range
string
required
progression_speed
string
required
use_year_over_year
string
required
use_search_volume_by_device
string
required
use_long_tail_effect
string
required
use_percentage_clicks
string
required
conversion_data
object {2}
required
overview_data
object {3}
required
additional_traffic
object {6}
required
inertial_traffic
object {3}
required
ads_equivalent
object {2}
required
monthly_forecast
object {3}
required
month
string
required
seasonality
string
required
traffic_data
object {5}
required
monthly_forecast_extended
object {3}
required
month
string
required
seasonality
string
required
traffic_data
object {5}
required
Example
{
"seo_goal": {
"keywords_count": "<integer>",
"search_data": {
"search_volume": "<integer>",
"year_over_year": "<double>",
"volume_by_device": {
"desktop": "<double>",
"mobile": "<double>"
},
"percentage_clicks": "<double>"
},
"target": {
"average_rank": {
"initial_rank": "<integer>",
"trend_3months": "<integer>",
"target_rank": "<integer>",
"best_target_rank": "<integer>"
},
"average_visibility": {
"initial_visibility": "<double>",
"trend_3months": "<double>",
"target_visibility": "<double>",
"best_target_visibility": "<integer>"
}
},
"goal_chance": "<string>"
},
"scenario_configuration": {
"timeframe": "<string>",
"start_month": "<string>",
"extended_forecast": "<boolean>",
"target_rank_range": "<boolean>",
"progression_speed": "<string>",
"use_year_over_year": "<boolean>",
"use_search_volume_by_device": "<boolean>",
"use_long_tail_effect": "<boolean>",
"use_percentage_clicks": "<boolean>",
"conversion_data": {
"conversion_rate": "<double>",
"avg_order_value": "<double>"
}
},
"overview_data": {
"additional_traffic": {
"sessions": "<integer>",
"sessions_best_target": "<integer>",
"conversions": "<integer>",
"conversions_best_target": "<integer>",
"revenue": "<integer>",
"revenue_best_target": "<integer>"
},
"inertial_traffic": {
"sessions": "<integer>",
"conversions": "<integer>",
"revenue": "<integer>"
},
"ads_equivalent": {
"equivalent": "<integer>",
"equivalent_best_target": "<integer>"
}
},
"monthly_forecast": {
"month": "<string>",
"seasonality": "<double>",
"traffic_data": {
"sessions": {
"inertial": "<integer>",
"additional": "<integer>",
"additional_best_target": "<integer>"
},
"conversions": {
"inertial": "<integer>",
"additional": "<integer>",
"additional_best_target": "<integer>"
},
"revenue": {
"inertial": "<integer>",
"additional": "<integer>",
"additional_best_target": "<integer>"
},
"visibility": {
"estimated": "<double>",
"estimated_best_target": "<integer>"
},
"estimated_avg_ranks": {
"estimated_best_target": "<integer>",
"estimated": "<double>"
}
}
},
"monthly_forecast_extended": {
"month": "<string>",
"seasonality": "<double>",
"traffic_data": {
"sessions": {
"inertial": "<integer>",
"additional": "<integer>",
"additional_best_target": "<integer>"
},
"conversions": {
"inertial": "<integer>",
"additional": "<integer>",
"additional_best_target": "<integer>"
},
"revenue": {
"inertial": "<integer>",
"additional": "<integer>",
"additional_best_target": "<integer>"
},
"visibility": {
"estimated": "<double>",
"estimated_best_target": "<integer>"
},
"estimated_avg_ranks": {
"estimated_best_target": "<integer>",
"estimated": "<double>"
}
}
}
}
Modified at 3 months ago