Core APIs
...
Search API
Reference
Google Web Selective Parsing
4min
This feature allows users to retrieve specific top-level objects from the response. Users can choose between POST and GET requests to specify which objects they want to parse
If the fields parameter is not provided or is an empty array, all available fields will be parsed.
Currently does not support selecting specific subfields within a top-level object.
Append fields param to your Google Web GET request to specify which fields to parse.
This feature is NOT supported in Batches
Parameter | Type | Required | Description |
---|---|---|---|
fields | GET | No | A list of top-level objects to parse. If omitted, all fields will be parsed. e.g. organic_results, top_sights, related_searches, etc |
To request Google Web using fields param, the request would be:
JS
1https://api.valueserp.com/search?api_key={key}&q=tomo+sushi+white+center&location=98146%2C+Washington%2C+United+States&gl=us&hl=en&google_domain=google.com&include_ai_overview=true&fields=organic_results,related_searches
Below is an example of resut
JS
{...}
"request_info":{...}
"success":true,
"credits_used":35,
"credits_used_this_request":1,
"credits_remaining":90,
"credits_reset_at":"2025-03-27T21:32:20.000Z",
"search_parameters":{...}
"q":"tomo sushi white center",
"location":"98146, Washington, United States",
"gl":"us",
"hl":"en",
"google_domain":"google.com",
"include_ai_overview":"true",
"fields":"organic_results,related_searches,top_sights",
"engine":"google",
"search_metadata":{...}
"created_at":"2025-03-04T21:47:43.902Z",
"processed_at":"2025-03-04T21:47:50.968Z",
"total_time_taken":7.07,
"engine_url":"https://www.google.com/search?q=tomo+sushi+white+center&gl=us&hl=en&uule=w+CAIQICIgOTgxNDYsIFdhc2hpbmd0b24sIFVuaXRlZCBTdGF0ZXM",
"html_url":"https://api.valueserp.com/search?api_key={apikey}&q=tomo+sushi+white+center&location=98146%2C+Washington%2C+United+States&gl=us&hl=en&google_domain=google.com&include_ai_overview=true&fields=organic_results%2Crelated_searches%2Ctop_sights&engine=google&output=html",
"json_url":"https://api.valueserp.com/search?api_key={apikey}&q=tomo+sushi+white+center&location=98146%2C+Washington%2C+United+States&gl=us&hl=en&google_domain=google.com&include_ai_overview=true&fields=organic_results%2Crelated_searches%2Ctop_sights&engine=google&output=json",
"organic_results":[...]
"0":{...}
"position":1,
"block_position":2,
"title":"TOMO",
"link":"https://tomoseattle.com/",
"domain":"tomoseattle.com",
"displayed_link":"https://tomoseattle.com",
"snippet":"front door of TOMO pre opening. White in White Center. Veggies. Center in White Center. crab. hand holding a bottle of wine. geoduck. fruit. White Center ...",
"prerender":false,
"sitelinks":{...}
"expanded":[...]
"0":{...}
"title":"More results from tomoseattle.com »",
"link":"/search?q=tomo+sushi+white+center+site:tomoseattle.com&sca_esv=efe80ebf88ba2062&gl=us&hl=en&sa=X&ved=2ahUKEwjbm_nJs_GLAxWVkK8BHQmNMgoQrAN6BAhEEAE",
"snippet":"",
"date_raw":"",
"date":null,
"answers":null,
"answers_raw":null,
"sitelinks_search_box":false,
"1":{...}
"position":2,
"block_position":3,
"title":"TOMO - Updated March 2025 - 572 Photos & 148 Reviews",
"link":"https://www.yelp.com/biz/tomo-seattle",
"domain":"www.yelp.com",
"displayed_link":"https://www.yelp.com › ... › Restaurants › New American",
"snippet":"... Tomo is an upscale trendy restaurant hidden in White Center. It was definitely an experience and all the waitstaff were very kind and knowledgeable. The ...",
"prerender":false,
"related_searches":[...]
"0":{...}
"query":"Tomo sushi white center menu",
"link":"https://www.google.com/search?sca_esv=efe80ebf88ba2062&gl=us&hl=en&q=Tomo+sushi+white+center+menu&sa=X&ved=2ahUKEwjbm_nJs_GLAxWVkK8BHQmNMgoQ1QJ6BQiGARAB",
"block_position":12,
"1":{...}
"query":"Tomo sushi white center reviews",
"link":"https://www.google.com/search?sca_esv=efe80ebf88ba2062&gl=us&hl=en&q=Tomo+sushi+white+center+reviews&sa=X&ved=2ahUKEwjbm_nJs_GLAxWVkK8BHQmNMgoQ1QJ6BQiEARAB",
"block_position":12,
"search_information":{...}
"original_query_yields_zero_results":false,
"total_results":225000,
Updated 04 Mar 2025
Did this page help you?