Here you will find all the necessary information about filters that can be used with DataForSEO Labs API endpoints.
Note that filters are associated with a certain object in the result array, and should be specified accordingly.
You can download the full list of possible filters by this link.
The list of available filtration parameters:
{
"related_keywords": {
"depth": "num",
"keyword_data.keyword": "str",
"keyword_data.keyword_info.last_updated_time": "time",
"keyword_data.keyword_info.competition": "num",
"keyword_data.keyword_info.cpc": "num",
"keyword_data.keyword_info.search_volume": "num",
"keyword_data.impressions_info.last_updated_time": "time",
"keyword_data.impressions_info.bid": "num",
"keyword_data.impressions_info.match_type": "str",
"keyword_data.impressions_info.ad_position_min": "num",
"keyword_data.impressions_info.ad_position_max": "num",
"keyword_data.impressions_info.ad_position_average": "num",
"keyword_data.impressions_info.cpc_min": "num",
"keyword_data.impressions_info.cpc_max": "num",
"keyword_data.impressions_info.cpc_average": "num",
"keyword_data.impressions_info.daily_impressions_min": "num",
"keyword_data.impressions_info.daily_impressions_max": "num",
"keyword_data.impressions_info.daily_impressions_average": "num",
"keyword_data.impressions_info.daily_clicks_min": "num",
"keyword_data.impressions_info.daily_clicks_max": "num",
"keyword_data.impressions_info.daily_clicks_average": "num",
"keyword_data.impressions_info.daily_cost_min": "num",
"keyword_data.impressions_info.daily_cost_max": "num",
"keyword_data.impressions_info.daily_cost_average": "num"
},
"keyword_suggestions": {
"keyword": "str",
"keyword_info.last_updated_time": "time",
"keyword_info.competition": "num",
"keyword_info.cpc": "num",
"keyword_info.search_volume": "num",
"impressions_info.bid": "num",
"impressions_info.match_type": "str",
"impressions_info.ad_position_min": "num",
"impressions_info.ad_position_max": "num",
"impressions_info.ad_position_average": "num",
"impressions_info.cpc_min": "num",
"impressions_info.cpc_max": "num",
"impressions_info.cpc_average": "num",
"impressions_info.daily_impressions_min": "num",
"impressions_info.daily_impressions_max": "num",
"impressions_info.daily_impressions_average": "num",
"impressions_info.daily_clicks_min": "num",
"impressions_info.daily_clicks_max": "num",
"impressions_info.daily_clicks_average": "num",
"impressions_info.daily_cost_min": "num",
"impressions_info.daily_cost_max": "num",
"impressions_info.daily_cost_average": "num"
},
"ranked_keywords": {
"keyword_data.keyword": "str",
"keyword_data.keyword_info.last_updated_time": "time",
"keyword_data.keyword_info.competition": "num",
"keyword_data.keyword_info.cpc": "num",
"keyword_data.keyword_info.search_volume": "num",
"keyword_data.impressions_info.last_updated_time": "time",
"keyword_data.impressions_info.bid": "num",
"keyword_data.impressions_info.match_type": "str",
"keyword_data.impressions_info.ad_position_min": "num",
"keyword_data.impressions_info.ad_position_max": "num",
"keyword_data.impressions_info.ad_position_average": "num",
"keyword_data.impressions_info.cpc_min": "num",
"keyword_data.impressions_info.cpc_max": "num",
"keyword_data.impressions_info.cpc_average": "num",
"keyword_data.impressions_info.daily_impressions_min": "num",
"keyword_data.impressions_info.daily_impressions_max": "num",
"keyword_data.impressions_info.daily_impressions_average": "num",
"keyword_data.impressions_info.daily_clicks_min": "num",
"keyword_data.impressions_info.daily_clicks_max": "num",
"keyword_data.impressions_info.daily_clicks_average": "num",
"keyword_data.impressions_info.daily_cost_min": "num",
"keyword_data.impressions_info.daily_cost_max": "num",
"keyword_data.impressions_info.daily_cost_average": "num",
"ranked_serp_element.check_url": "str",
"ranked_serp_element.se_results_count": "num",
"ranked_serp_element.last_updated_time": "time",
"ranked_serp_element.serp_item.type": "str",
"ranked_serp_element.serp_item.rank_group": "num",
"ranked_serp_element.serp_item.rank_absolute": "num",
"ranked_serp_element.serp_item.position": "str",
"ranked_serp_element.serp_item.xpath": "str",
"ranked_serp_element.serp_item.title": "str",
"ranked_serp_element.serp_item.pre_snippet": "str",
"ranked_serp_element.serp_item.description": "str",
"ranked_serp_element.serp_item.breadcrumb": "str",
"ranked_serp_element.serp_item.is_image": "bool",
"ranked_serp_element.serp_item.is_video": "bool",
"ranked_serp_element.serp_item.is_featured_snippet": "bool",
"ranked_serp_element.serp_item.amp_version": "bool",
"ranked_serp_element.serp_item.is_malicious": "bool",
"ranked_serp_element.serp_item.extended_snippet": "str",
"ranked_serp_element.serp_item.domain": "str",
"ranked_serp_element.serp_item.url": "str",
"ranked_serp_element.serp_item.relative_url": "str",
"ranked_serp_element.serp_item.main_domain": "str",
"ranked_serp_element.serp_item.etv": "num",
"ranked_serp_element.serp_item.impressions_etv": "num",
"ranked_serp_element.serp_item.estimated_paid_traffic_cost": "num",
"ranked_serp_element.extra.ad_aclk": "str",
"ranked_serp_element.description_rows": "str",
"ranked_serp_element.phone": "str",
"ranked_serp_element.is_paid": "bool",
"ranked_serp_element.featured_title": "str"
},
"keyword_ideas": {
"keyword": "str",
"keyword_info.last_updated_time": "time",
"keyword_info.competition": "num",
"keyword_info.cpc": "num",
"keyword_info.search_volume": "num",
"impressions_info.bid": "num",
"impressions_info.match_type": "str",
"impressions_info.ad_position_min": "num",
"impressions_info.ad_position_max": "num",
"impressions_info.ad_position_average": "num",
"impressions_info.cpc_min": "num",
"impressions_info.cpc_max": "num",
"impressions_info.cpc_average": "num",
"impressions_info.daily_impressions_min": "num",
"impressions_info.daily_impressions_max": "num",
"impressions_info.daily_impressions_average": "num",
"impressions_info.daily_clicks_min": "num",
"impressions_info.daily_clicks_max": "num",
"impressions_info.daily_clicks_average": "num",
"impressions_info.daily_cost_min": "num",
"impressions_info.daily_cost_max": "num",
"impressions_info.daily_cost_average": "num"
},
"serp_competitors": {
"domain": "str",
"avg_position": "num",
"median_position": "num",
"rating": "num",
"etv": "num",
"keywords_count": "num",
"visibility": "num",
"relevant_serp_items": "num"
},
"relevant_pages": {
"metrics.paid.pos_1": "num",
"metrics.paid.pos_2_3": "num",
"metrics.paid.pos_4_10": "num",
"metrics.paid.pos_11_20": "num",
"metrics.paid.pos_21_30": "num",
"metrics.paid.pos_31_40": "num",
"metrics.paid.pos_41_50": "num",
"metrics.paid.pos_51_60": "num",
"metrics.paid.pos_61_70": "num",
"metrics.paid.pos_71_80": "num",
"metrics.paid.pos_81_90": "num",
"metrics.paid.pos_91_100": "num",
"metrics.paid.etv": "num",
"metrics.paid.impressions_etv": "num",
"metrics.paid.count": "num",
"metrics.paid.estimated_paid_traffic_cost": "num",
"metrics.organic.pos_1": "num",
"metrics.organic.pos_2_3": "num",
"metrics.organic.pos_4_10": "num",
"metrics.organic.pos_11_20": "num",
"metrics.organic.pos_21_30": "num",
"metrics.organic.pos_31_40": "num",
"metrics.organic.pos_41_50": "num",
"metrics.organic.pos_51_60": "num",
"metrics.organic.pos_61_70": "num",
"metrics.organic.pos_71_80": "num",
"metrics.organic.pos_81_90": "num",
"metrics.organic.pos_91_100": "num",
"metrics.organic.etv": "num",
"metrics.organic.impressions_etv": "num",
"metrics.organic.count": "num",
"metrics.organic.estimated_paid_traffic_cost": "num"
},
"subdomains": {
"metrics.paid.pos_1": "num",
"metrics.paid.pos_2_3": "num",
"metrics.paid.pos_4_10": "num",
"metrics.paid.pos_11_20": "num",
"metrics.paid.pos_21_30": "num",
"metrics.paid.pos_31_40": "num",
"metrics.paid.pos_41_50": "num",
"metrics.paid.pos_51_60": "num",
"metrics.paid.pos_61_70": "num",
"metrics.paid.pos_71_80": "num",
"metrics.paid.pos_81_90": "num",
"metrics.paid.pos_91_100": "num",
"metrics.paid.etv": "num",
"metrics.paid.impressions_etv": "num",
"metrics.paid.count": "num",
"metrics.paid.estimated_paid_traffic_cost": "num",
"metrics.organic.pos_1": "num",
"metrics.organic.pos_2_3": "num",
"metrics.organic.pos_4_10": "num",
"metrics.organic.pos_11_20": "num",
"metrics.organic.pos_21_30": "num",
"metrics.organic.pos_31_40": "num",
"metrics.organic.pos_41_50": "num",
"metrics.organic.pos_51_60": "num",
"metrics.organic.pos_61_70": "num",
"metrics.organic.pos_71_80": "num",
"metrics.organic.pos_81_90": "num",
"metrics.organic.pos_91_100": "num",
"metrics.organic.etv": "num",
"metrics.organic.impressions_etv": "num",
"metrics.organic.count": "num",
"metrics.organic.estimated_paid_traffic_cost": "num"
},
"competitors_domain": {
"avg_position": "num",
"sum_position": "num",
"intersections": "num",
"metrics.paid.pos_1": "num",
"metrics.paid.pos_2_3": "num",
"metrics.paid.pos_4_10": "num",
"metrics.paid.pos_11_20": "num",
"metrics.paid.pos_21_30": "num",
"metrics.paid.pos_31_40": "num",
"metrics.paid.pos_41_50": "num",
"metrics.paid.pos_51_60": "num",
"metrics.paid.pos_61_70": "num",
"metrics.paid.pos_71_80": "num",
"metrics.paid.pos_81_90": "num",
"metrics.paid.pos_91_100": "num",
"metrics.paid.etv": "num",
"metrics.paid.impressions_etv": "num",
"metrics.paid.count": "num",
"metrics.paid.estimated_paid_traffic_cost": "num",
"metrics.organic.pos_1": "num",
"metrics.organic.pos_2_3": "num",
"metrics.organic.pos_4_10": "num",
"metrics.organic.pos_11_20": "num",
"metrics.organic.pos_21_30": "num",
"metrics.organic.pos_31_40": "num",
"metrics.organic.pos_41_50": "num",
"metrics.organic.pos_51_60": "num",
"metrics.organic.pos_61_70": "num",
"metrics.organic.pos_71_80": "num",
"metrics.organic.pos_81_90": "num",
"metrics.organic.pos_91_100": "num",
"metrics.organic.etv": "num",
"metrics.organic.impressions_etv": "num",
"metrics.organic.count": "num",
"metrics.organic.estimated_paid_traffic_cost": "num"
},
"categories_for_domain": {
"metrics.paid.pos_1": "num",
"metrics.paid.pos_2_3": "num",
"metrics.paid.pos_4_10": "num",
"metrics.paid.pos_11_20": "num",
"metrics.paid.pos_21_30": "num",
"metrics.paid.pos_31_40": "num",
"metrics.paid.pos_41_50": "num",
"metrics.paid.pos_51_60": "num",
"metrics.paid.pos_61_70": "num",
"metrics.paid.pos_71_80": "num",
"metrics.paid.pos_81_90": "num",
"metrics.paid.pos_91_100": "num",
"metrics.paid.etv": "num",
"metrics.paid.impressions_etv": "num",
"metrics.paid.count": "num",
"metrics.paid.estimated_paid_traffic_cost": "num",
"metrics.organic.pos_1": "num",
"metrics.organic.pos_2_3": "num",
"metrics.organic.pos_4_10": "num",
"metrics.organic.pos_11_20": "num",
"metrics.organic.pos_21_30": "num",
"metrics.organic.pos_31_40": "num",
"metrics.organic.pos_41_50": "num",
"metrics.organic.pos_51_60": "num",
"metrics.organic.pos_61_70": "num",
"metrics.organic.pos_71_80": "num",
"metrics.organic.pos_81_90": "num",
"metrics.organic.pos_91_100": "num",
"metrics.organic.etv": "num",
"metrics.organic.impressions_etv": "num",
"metrics.organic.count": "num",
"metrics.organic.estimated_paid_traffic_cost": "num"
},
"keywords_for_categories": {
"keyword": "str",
"keyword_info.last_updated_time": "time",
"keyword_info.competition": "num",
"keyword_info.cpc": "num",
"keyword_info.search_volume": "num",
"impressions_info.bid": "num",
"impressions_info.match_type": "str",
"impressions_info.ad_position_min": "num",
"impressions_info.ad_position_max": "num",
"impressions_info.ad_position_average": "num",
"impressions_info.cpc_min": "num",
"impressions_info.cpc_max": "num",
"impressions_info.cpc_average": "num",
"impressions_info.daily_impressions_min": "num",
"impressions_info.daily_impressions_max": "num",
"impressions_info.daily_impressions_average": "num",
"impressions_info.daily_clicks_min": "num",
"impressions_info.daily_clicks_max": "num",
"impressions_info.daily_clicks_average": "num",
"impressions_info.daily_cost_min": "num",
"impressions_info.daily_cost_max": "num",
"impressions_info.daily_cost_average": "num"
},
"ranked_domains_by_category": {
"metrics.paid.pos_1": "num",
"metrics.paid.pos_2_3": "num",
"metrics.paid.pos_4_10": "num",
"metrics.paid.pos_11_20": "num",
"metrics.paid.pos_21_30": "num",
"metrics.paid.pos_31_40": "num",
"metrics.paid.pos_41_50": "num",
"metrics.paid.pos_51_60": "num",
"metrics.paid.pos_61_70": "num",
"metrics.paid.pos_71_80": "num",
"metrics.paid.pos_81_90": "num",
"metrics.paid.pos_91_100": "num",
"metrics.paid.etv": "num",
"metrics.paid.impressions_etv": "num",
"metrics.paid.count": "num",
"metrics.paid.estimated_paid_traffic_cost": "num",
"metrics.organic.pos_1": "num",
"metrics.organic.pos_2_3": "num",
"metrics.organic.pos_4_10": "num",
"metrics.organic.pos_11_20": "num",
"metrics.organic.pos_21_30": "num",
"metrics.organic.pos_31_40": "num",
"metrics.organic.pos_41_50": "num",
"metrics.organic.pos_51_60": "num",
"metrics.organic.pos_61_70": "num",
"metrics.organic.pos_71_80": "num",
"metrics.organic.pos_81_90": "num",
"metrics.organic.pos_91_100": "num",
"metrics.organic.etv": "num",
"metrics.organic.impressions_etv": "num",
"metrics.organic.count": "num",
"metrics.organic.estimated_paid_traffic_cost": "num"
},
"domain_intersection": {
"keyword_data.keyword": "str",
"keyword_data.keyword_info.last_updated_time": "time",
"keyword_data.keyword_info.competition": "num",
"keyword_data.keyword_info.cpc": "num",
"keyword_data.keyword_info.search_volume": "num",
"impressions_info.bid": "num",
"impressions_info.match_type": "str",
"impressions_info.ad_position_min": "num",
"impressions_info.ad_position_max": "num",
"impressions_info.ad_position_average": "num",
"impressions_info.cpc_min": "num",
"impressions_info.cpc_max": "num",
"impressions_info.cpc_average": "num",
"impressions_info.daily_impressions_min": "num",
"impressions_info.daily_impressions_max": "num",
"impressions_info.daily_impressions_average": "num",
"impressions_info.daily_clicks_min": "num",
"impressions_info.daily_clicks_max": "num",
"impressions_info.daily_clicks_average": "num",
"impressions_info.daily_cost_min": "num",
"impressions_info.daily_cost_max": "num",
"impressions_info.daily_cost_average": "num",
"first_domain_serp_element.type": "str",
"first_domain_serp_element.rank_group": "num",
"first_domain_serp_element.rank_absolute": "num",
"first_domain_serp_element.position": "str",
"first_domain_serp_element.xpath": "str",
"first_domain_serp_element.title": "str",
"first_domain_serp_element.pre_snippet": "str",
"first_domain_serp_element.description": "str",
"first_domain_serp_element.breadcrumb": "str",
"first_domain_serp_element.is_image": "bool",
"first_domain_serp_element.is_video": "bool",
"first_domain_serp_element.is_featured_snippet": "bool",
"first_domain_serp_element.amp_version": "bool",
"first_domain_serp_element.is_malicious": "bool",
"first_domain_serp_element.extended_snippet": "str",
"first_domain_serp_element.domain": "str",
"first_domain_serp_element.main_domain": "str",
"first_domain_serp_element.url": "str",
"first_domain_serp_element.relative_url": "str",
"first_domain_serp_element.etv": "num",
"first_domain_serp_element.impressions_etv": "num",
"first_domain_serp_element.estimated_paid_traffic_cost": "num",
"first_domain_serp_element.extra.ad_aclk": "str",
"first_domain_serp_element.description_rows": "str",
"first_domain_serp_element.phone": "str",
"first_domain_serp_element.is_paid": "bool",
"first_domain_serp_element.featured_title": "str",
"second_domain_serp_element.type": "str",
"second_domain_serp_element.rank_group": "num",
"second_domain_serp_element.rank_absolute": "num",
"second_domain_serp_element.position": "str",
"second_domain_serp_element.xpath": "str",
"second_domain_serp_element.title": "str",
"second_domain_serp_element.pre_snippet": "str",
"second_domain_serp_element.description": "str",
"second_domain_serp_element.breadcrumb": "str",
"second_domain_serp_element.is_image": "bool",
"second_domain_serp_element.is_video": "bool",
"second_domain_serp_element.is_featured_snippet": "bool",
"second_domain_serp_element.amp_version": "bool",
"second_domain_serp_element.is_malicious": "bool",
"second_domain_serp_element.extended_snippet": "str",
"second_domain_serp_element.domain": "str",
"second_domain_serp_element.main_domain": "str",
"second_domain_serp_element.url": "str",
"second_domain_serp_element.relative_url": "str",
"second_domain_serp_element.etv": "num",
"second_domain_serp_element.impressions_etv": "num",
"second_domain_serp_element.estimated_paid_traffic_cost": "num",
"second_domain_serp_element.extra.ad_aclk": "str",
"second_domain_serp_element.description_rows": "str",
"second_domain_serp_element.phone": "str",
"second_domain_serp_element.is_paid": "bool",
"second_domain_serp_element.featured_title": "str"
}
}
Below you will find a detailed description of the filtering options available for DataForSEO Labs API.
Description of the field:
| Field name | Type | Description |
|---|---|---|
filters |
array | array of results filtering parameters optional field you can add several filters at once (8 filters maximum) you should set a logical operator and, or between the conditionsfilters have the following structure: [$item_array.$results_array.$parameter_field, $filter_operator, $filter_value]you should use the . and , symbols as separatorsexample: ["keyword_data.impressions_info.daily_impressions_average", ">=", 50] |
$item_array |
str | item name in the filter optional field possible values: keyword_data, ranked_serp_element |
$results_array |
str | results array in the filter optional field possible values: keyword, keyword_info, impressions_info, check_url, se_results_count, serp_item, metrics |
$parameter_field |
str | parameter field in the filter optional field required field if the filter is applied the parameter in the superordinate $results_array or item_arrayrepresents the field you want to filter the results by |
$filter_operator |
str | operator in the filter optional field required field if the filter is applied available filter operators: • if bool: =, <>• if num: <, <=, >, >=, =, <>, in, not_in• if str: like, not_like, in, not_in, =, <>• if time: <, >
if you specify note that |
$filter_value |
num str bool |
filtering value optional field required field if the filter is applied |
Related Keywords |
||
| possible filters | num str time |
the examples of available filters for the Related Keywords endpoint:'keyword_data.keyword' => 'str'You can get the full list of possible filters by this link |
Keyword Suggestions |
||
| possible filters | num str time |
the examples of available filters for the Keyword Suggestions endpoint:'keyword' => 'str'You can get the full list of possible filters by this link |
Keyword Ideas |
||
| possible filters | num str time |
the examples of available filters for the Keyword Ideas endpoint:'keyword' => 'str'You can get the full list of possible filters by this link |
Ranked Keywords |
||
| possible filters | num str time bool |
the examples of available filters for the Ranked Keywords endpoint:'keyword_data.keyword' => 'str'
if you want to get the keywords a particular webpage ranks for, specify the filter by the |
Keywords For Categories |
||
| possible filters | num str time |
the examples of available filters for the Keywords For Categories endpoint:'keyword' => 'str'You can get the full list of possible filters by this link |
Domain Intersection |
||
| possible filters | num str time bool |
the examples of available filters for the Domain Intersection endpoint:'keyword_data.keyword' => 'str'You can get the full list of possible filters by this link |
Competitors Domain |
||
| possible filters | num str |
the examples of available filters for the Competitors Domain endpoint:'domain' => 'str'You can get the full list of possible filters by this link |
Categories For Domain |
||
| possible filters | num | the examples of available filters for the Categories For Domain endpoint:'metrics.paid.etv' => 'num'You can get the full list of possible filters by this link |
Relevant Pages |
||
| possible filters | num str |
the examples of available filters for the Relevant Pages endpoint:'page_address' => 'str'You can get the full list of possible filters by this link |
SERP Competitors |
||
| possible filters | num str |
the list of available filters for the SERP Competitors endpoint:'domain' => 'str'You can get the full list of possible filters by this link |
Subdomains |
||
| possible filters | num str time |
the examples of available filters for the Subdomains endpoint:'sub_domain' => 'str'You can get the full list of possible filters by this link |