google_ads template is built to obtain Google Search and Google AI Overview results, prioritizing paid advertisements at the highest ad display rate. It limits the output to ten results per page, maximizing the likelihood of paid ads appearing.
Useful Links
- More information on optimizing the AI Overview rate can be found here.
- Real-time and Asynchronous integration methods are available for this template.
- Batch requests are also supported.
Some
google_ads requests fail with status code 613, even with valid parameters. Retry failed requests.Input Parameters
Request parameters available for the Google Ads template:| Parameter | Type | Required | Description |
|---|---|---|---|
target | string | ✅ | Target type must be set to google_ads. |
query | string | ✅ | Search query. |
headless | string | html value enables JavaScript rendering. Read more.png value enables screenshot response. Read more. | |
parse | boolean | Automatically parses results when set to true. Default value is false. | |
geo | string | Set the country to use when submitting the query. Read more. | |
locale | string | Set the value to change your Google search page web interface language. Read more. | |
device_type | string | Specify device type and browser. Read more. | |
page_from | string | Customize the starting page number within the range of 1 to 10. Default value is 1. | |
page_count | integer | Customize the desired page count number within the range of 1 to 10.Each page provides 10 search results. Default value is 1. | |
google_results_language | string | Return results in a specified language. See all options here . | |
google_tbm | string | Filter search results for specific types of content (news, apps, videos…). More information here . Sample value: app. | |
google_tbs | string | This parameter contains parameters like limiting/sorting results by date. More information here . Example: qdr:w (results from last week). | |
google_nfpr | boolean | Turns off spelling auto-correction when set to true. Default value is false. | |
xhr | boolean | Set to true to retrieve a list of XHR and fetch requests.Read more.Default value is false. | |
markdown | boolean | Set to true to receive a Markdown response. Read more.Default value is false. |
Request Examples
# update 'TOKEN VALUE' with your API KEY
curl --request 'POST' \
--url 'https://data.decodo.com/v1/scrape' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer TOKEN VALUE' \
--header 'Content-Type: application/json' \
--data '
{
"target": "google_ads",
"query": "laptop",
"headless": "html",
"page_from": "1",
"google_results_language": "en",
"parse": true
}
'
const scrape = async() => {
const response = await fetch("https://data.decodo.com/v1/scrape", {
method: "POST",
body: JSON.stringify({
"target": "google_ads",
"query": "pizza",
"headless": "html",
"page_from": "1",
"google_results_language": "en",
"parse": true
}),
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer TOKEN VALUE" // update with your API KEY
},
}).catch(error => console.log(error));
console.log(await response.json())
}
scrape()
import requests
url = "https://data.decodo.com/v1/scrape"
payload = {
"target": "google_ads",
"query": "pizza",
"headless": "html",
"page_from": "1",
"google_results_language": "en",
"parse": True
}
headers = {
"accept": "application/json",
"content-type": "application/json",
"authorization": "Bearer TOKEN VALUE" # update with your API KEY
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
Output
Descriptions for fields in the parsedJSON results section are provided in the table below. Keep in mind that the number of fields can vary according to the provided search query.
| Results key | Description |
|---|---|
pla | An object of product ads with their detailed information. |
paid | An array of sponsored results with their detailed information. |
images | An object of an image results with its detailed information. |
flights | An object of flights with their detailed information. |
organic | An array of organic listings with their detailed information. |
organic_videos | An array of organic videos with their detailed information. |
top_sights | An array of landmarks or attractions with their detailed information. |
jobs | An object of jobs with their detailed information. |
local_service_ads | An object of sponsored local service providers. |
video_boxes | An array of a video items with detailed information. |
recipes | An object of recipes with detailed information. |
twitter | An array of X (previously Twitter) results with detailed information. |
knowledge | An object of information gathered from the knowledge panel. |
local_pack | An object of local business listings relevant to the query. |
item_carousel | An object of illustrative items for informational queries with detailed information. |
videos | An object of videos with detailed information. |
hotels | An object of hotels relevant to the location of a query. |
apps | An array of applications with detailed information. |
finance | An object of financial data for companies, including stock prices, market capitalization, and other essential metrics. |
sports_games | An object of recent sports events, including scores, teams, game types, and key highlights. |
discussions_and_forums | An object of discussion threads and forum posts, including their URLs, titles, sources, and comment counts. |
featured_snippet | An array of specific results retrieved from the organic part of the results page. |
top_stories | An object of articles with their detailed information when a query is identified as news-oriented. |
popular_products | An object of organic displays of Google Shopping product listings with detailed information. |
related_searches | An array of one or more related searches blocks displayed at various positions on the search results page. |
related_questions | An object of related question-based search queries, along with detailed information. |
what_people_are_saying | An array of discussion threads and forum posts, including their URLs, titles, sources, top comments, engagement metrics, and timeframes.” |
search_information | An object of information related to the submitted search query. |
Response Example
{
"results": [
{
"content": {
"results": {
"last_visible_page": 10,
"page": 1,
"parse_status_code": 12000,
"results": {
"ai_overviews": [
{
"answer_text": [
{
"fragments": [
{
"references": [
{
"source": "Wikipedia",
"url": "/goto?url=CAESXwHrOzAV8SW5zAtwsMvXKOOnnN57n1rTAtK0H5-_P4FtT55whr9ZCzQ_jIaeePxE3WG5vHaZ50xe-9n7hX0UF9JHHb1IyC7Unp8CwcmTKTpmCZ9zT1sQ6aB7tjrrAZrA"
}
],
"text": "A laptop is a portable personal computer designed for mobile use, combining a screen, keyboard, and internal hardware into a single clamshell housing. Wikipedia"
}
],
"pos": 1
}
],
"bullet_list": [
{
"list_title": "Popular Types and Features",
"points": [
{
"text": "Clamshell Laptops: Traditional design focused on productivity and everyday computing. Wikipedia"
},
{
"text": "2-in-1 Convertibles: Features touchscreens and 360-degree hinges or detachable keyboards to function as both a tablet and a computer."
}
],
"pos": 1
},
{
"list_title": "Pricing and Cost",
"points": [
{
"text": "Typical Cost Range:"
}
],
"pos": 2
}
],
"pos_overall": 1,
"source_panel": {
"items": [
{
"pos": 1,
"source": "en.wikipedia.org",
"url": "/goto?url=CAESXwHrOzAV6D0DdYdUUbB1BohUN0Efw6CJBdlKI_HiI2LpStMcEsM4T0l_HOumhgONjsds90h4PlkL2b9EHahJGJrbfiUa3U8LtFlvbo-4H2iaOhbuqx_R276ZnbogdPfj"
},
{
"pos": 2,
"source": "dell.com",
"url": "/goto?url=CAESdgHrOzAV9Kc18uNulAcmSkIleaL5qmzkqmC7shrAySYpUErB30dUW_DJ6T0Wn3X9NYDfOZNt_sH5qFTaYb95IhrixAzWEJXhoaRIoZFBoxoGFxpVxTJtXqdSYDSM-j5uCBN3MNkoPvBYTuh3UDN-vY8bIsRcHCw"
}
]
}
}
],
"images": {
"items": [
{
"alt": "Surface Laptop, 13.8-inch (7th Edition)",
"data": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
"pos": 1,
"url": "https://www.microsoft.com/en-us/store/configure/surface-laptop-13-8-inch/8mzbmmcjzqjk"
},
{
"alt": "The 15 Best Laptops of 2026 | Reviews by Wirecutter",
"data": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
"pos": 2,
"url": "https://www.nytimes.com/wirecutter/reviews/best-laptops/"
}
],
"pos_overall": 14
},
"local_pack": [
{
"items": [
{
"address": "711 West 2nd St N",
"links": [
{
"href": "/goto?url=CAESiAEB6zswFRAG67N2kYHN3xflXTAA3TgnOJ7V_8Xa5HpCHAUP1MuX0YS5Kb943M2EwNSbAIPHEe9ZOM5eQbqRSHB9q1zO85CftLQEhCwfMnUXTigbxPzi4ualGqni0EZ06VUVeh2cmDFzP6PbFida3ylQOxHMv_cC2cyPQSi4Ix9W4pPb9wtrgXef",
"title": "Website"
},
{
"href": "/maps/dir//Wichita+Public+Library+-+Advanced+Learning+Library,+711+West+2nd+St+N,+Wichita,+KS+67203/data=!4m6!4m5!1m1!4e2!1m2!1m1!1s0x87bae3de1aa91d7f:0x156102a5cfe7f7a9?sa=X&ved=1t:57443&gl=us&ictx=111",
"title": "Directions"
}
],
"paid": false,
"phone": "(316) 261-8500",
"pos": 1,
"rating": 4.7,
"rating_count": 513,
"subtitle": "Public library",
"title": "Wichita Public Library - Advanced Learning Library"
},
{
"address": "126 N West St Ste a",
"links": [
{
"href": "/goto?url=CAESVwHrOzAVG4BVnKnil_s4KR9UyjVg-LVlmAib_fAf81eMXaqkC_VN_nFSgLfc69bQKRGsGPNShjbHzCQR1M4MVZ2xPWAC8iC9lU9iNamuKuY5CwKEY3zEAA",
"title": "Website"
},
{
"href": "/maps/dir//Ribbit+Computers,+126+N+West+St+Ste+a,+Wichita,+KS+67203/data=!4m6!4m5!1m1!4e2!1m2!1m1!1s0x87bae118c5b3afe7:0xe551195af128501a?sa=X&ved=1t:57443&gl=us&ictx=111",
"title": "Directions"
}
],
"paid": false,
"phone": "(316) 612-1500",
"pos": 2,
"rating": 4.5,
"rating_count": 490,
"subtitle": "Computer repair service",
"title": "Ribbit Computers"
}
],
"pos_overall": 6
}
],
"navigation": [
{
"pos": 1,
"title": "AI Mode",
"url": "/search?q=laptop&sca_esv=b44634d0b9d75b78&gl=us&sxsrf=APpeQnss5UUPfe1PaazCzjaNBuizgF_q-Q:1791271533914&udm=50&fbs=ABfTbFVyMZGZf1hfvX9uKjN_-G8cqCQj_06QnZs315LoFmPf5bBLHMJ0vMQmTbuI72DM7jnxvATrUU2Yg9dwuU..."
},
{
"pos": 2,
"title": "All"
}
],
"organic": [
{
"desc": "Aug 31, 2026 — We've tested hundreds of laptops over the years, ASUS Zenbook A14 is a budget laptop for graphic design … at just $599/£599, this is a great- ...",
"favicon_text": "Creative Bloq",
"pos": 1,
"pos_overall": 3,
"title": "The best budget laptops for graphic design students",
"url": "https://www.creativebloq.com/tech/laptops/the-best-budget-laptops-for-graphic-design-students",
"url_shown": "https://www.creativebloq.com› ... › Laptops"
},
{
"desc": "May 29, 2026 — Basically, a 2-in-1 laptop is a portable computer that works as both a laptop and a tablet. It has a touchscreen and a design that lets you ...Read more",
"favicon_text": "HONOR",
"pos": 2,
"pos_overall": 5,
"title": "What Is a 2-in-1 Laptop? The Flexible Tech Option Explained",
"url": "https://www.honor.com/ae-en/blog/what-is-a-2-in-1-laptop/?srsltid=AU7gw4XRnV4KsudkpwDjzxQDgfaK8ddRzWiWptSAh-Des6yvzIbJbpL6",
"url_shown": "https://www.honor.com› Homepage › Blog"
}
],
"paid": [],
"popular_products": [
{
"items": [
{
"currency": "USD",
"description": "Best Buy & more",
"image_data": "UklGRjgWAABXRUJQVlA4ICwWAABwWgCdASrdALYAPkkgjUSioiEjqJOcOHAJCWMn5n9brPwKYoBKLTtYTdZ/svOp5R7dfRGnLgC4o8ovm7zs+jT9I+wb+tPTg8y/3He65/wPXVvQHoudMhYx+uvyX/EpcJxX2S/leuX+q8C/lZqEPO7RT3L+7f9H0hPyPN/7S+wF5if9...",
"pos": 1,
"rating": "4.6",
"rating_count": 100,
"sellers": [
{
"pos": 1,
"price_old_str": "$350",
"price_str": "$209.99",
"seller_name": "Best Buy"
}
],
"title": "HP 14\" HD Laptop Intel Processor N150 4GB RAM",
"token": "eyJjYXRhbG9naWQiOiAiMzM0ODA0ODExODUxMTczNDE5OSIsICJwcm9kdWN0aWQiOiAiMTgyMTY1MzkwNTY2MTk1Mjk3NjEiLCAiaGVhZGxpbmVPZmZlckRvY2lkIjogIjE0OTE1ODQ5MzgzODIwNzk2Njg3IiwgImltYWdlRG9jaWQiOiAiNTcxODU5Nzk1NTU2MDkx...",
"url": "https://www.google.com/search?ibp=oshop&q=laptop&prds=catalogid:3348048118511734199,productid:18216539056619529761,headlineOfferDocid:14915849383820796687,imageDocid:5718597955560917838,rds:PC_1624014..."
},
{
"currency": "USD",
"description": "Target & more",
"image_data": "UklGRtwOAABXRUJQVlA4INAOAACQSACdASrMANoAPkEejUQioaGVSkUEKAQEo7VAn9eRlcQAHmHzt+5/rnovWx+9fh3iiLA8ovnD/n+in1Tfpb2DP126g3nE/a/1OPS//YPUg/sXpMesf/afUT/bf06P27+J3ymcHL015iSbMcl9YxJmQPdh5bvCjxR9tV69+M/9l8tX...",
"pos": 2,
"rating": "4.8",
"rating_count": 6100,
"sellers": [
{
"pos": 1,
"price_str": "$699.99",
"seller_name": "Target"
}
],
"title": "Apple MacBook Neo 13\" A18 Pro chip",
"token": "eyJjYXRhbG9naWQiOiAiODA3MTAzNzgwODI5NzA3ODM1NyIsICJwcm9kdWN0aWQiOiAiMTc5NTE3NjgyMzk4MTExNjc0MDQiLCAiaGVhZGxpbmVPZmZlckRvY2lkIjogIjE3Nzk2OTQ1MDkxODg2MzExODciLCAiaW1hZ2VEb2NpZCI6ICI0ODA4NTg4MTUzNzgxMDEw...",
"url": "https://www.google.com/search?ibp=oshop&q=laptop&prds=catalogid:8071037808297078357,productid:17951768239811167404,headlineOfferDocid:1779694509188631187,imageDocid:4808588153781010117,rds:PC_63769255..."
}
],
"pos_overall": 2
},
{
"items": [
{
"currency": "USD",
"description": "Best Buy & more",
"pos": 1,
"rating": "4.6",
"rating_count": 198,
"sellers": [
{
"pos": 1,
"price_old_str": "$419",
"price_str": "$189.00",
"seller_name": "Best Buy"
}
],
"title": "Lenovo IdeaPad Slim 3 14\" Touchscreen Chromebook",
"token": "eyJjYXRhbG9naWQiOiAiMTQ2NzA1Njk3MjA2MzczMzgzMTUiLCAicHJvZHVjdGlkIjogIjk1OTkyNTcwMjM4Mzg5Mzc1MTYiLCAiaGVhZGxpbmVPZmZlckRvY2lkIjogIjg0NzAzNDU0MjE4NDQ1MDA3ODAiLCAiaW1hZ2VEb2NpZCI6ICIxNjE3MDU5MDQyNDkxMzQ0...",
"url": "https://www.google.com/search?ibp=oshop&q=laptop&prds=catalogid:14670569720637338315,productid:9599257023838937516,headlineOfferDocid:8470345421844500780,imageDocid:1617059042491344067,rds:PC_15183020...",
"url_image": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcSYShHc3Mqhpm_2xUHaaompi-Vs7vNW8sOfq7nt01aKsj_9EQRBhYu8Kjsb9cAdnQSSszQvrbDtgNOympDZaaKSZXIhzk0p0EsKaU-OklbMCrwF1Ysz_rTvUA"
},
{
"currency": "USD",
"description": "Best Buy & more",
"pos": 2,
"rating": "4.6",
"rating_count": 100,
"sellers": [
{
"pos": 1,
"price_old_str": "$350",
"price_str": "$209.99",
"seller_name": "Best Buy"
}
],
"title": "HP 14\" HD Laptop Intel Processor N150 4GB RAM",
"token": "eyJjYXRhbG9naWQiOiAiMzM0ODA0ODExODUxMTczNDE5OSIsICJwcm9kdWN0aWQiOiAiMTgyMTY1MzkwNTY2MTk1Mjk3NjEiLCAiaGVhZGxpbmVPZmZlckRvY2lkIjogIjE0OTE1ODQ5MzgzODIwNzk2Njg3IiwgImltYWdlRG9jaWQiOiAiNTcxODU5Nzk1NTU2MDkx...",
"url": "https://www.google.com/search?ibp=oshop&q=laptop&prds=catalogid:3348048118511734199,productid:18216539056619529761,headlineOfferDocid:14915849383820796687,imageDocid:5718597955560917838,rds:PC_1624014...",
"url_image": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcSQ_kOoJBEF_ankGwNrQFD383zW_h85plG8K8bp2H2QTIQVYpU_rVdL5sAsOq5Ew0C-0yMls7rj4CeNtsD0YAvZNELoaQgrn_zblE-rAK15BwSF118k1hcX"
}
],
"pos_overall": 4
}
],
"related_questions": {
"items": [
{
"pos": 1,
"question": "Which brand of laptop is the best?"
},
{
"pos": 2,
"question": "What laptop to stay away from?"
}
],
"pos_overall": 10
},
"related_searches": [
{
"pos_overall": 15,
"related_searches": [
"Laptop gaming",
"Laptop amazon"
],
"related_searches_urls": [
"https://www.google.com/search?sca_esv=b44634d0b9d75b78&gl=us&sxsrf=APpeQnss5UUPfe1PaazCzjaNBuizgF_q-Q:1791271533914&q=Laptop+gaming&sa=X&ved=2ahUKEwjSlea77qSXAxXhmWoFHTubNgMQ1QJ6BAhgEAE",
"https://www.google.com/search?sca_esv=b44634d0b9d75b78&gl=us&sxsrf=APpeQnss5UUPfe1PaazCzjaNBuizgF_q-Q:1791271533914&q=Laptop+amazon&sa=X&ved=2ahUKEwjSlea77qSXAxXhmWoFHTubNgMQ1QJ6BAhkEAE"
]
}
],
"search_information": {
"geo_location": "Wichita, KS 67202",
"no_results_for_original_query_found": false,
"query": "laptop",
"showing_results_for": "laptop",
"time_taken_displayed": null,
"total_results_count": 3790000
},
"total_results_count": 3790000
},
"url": "https://www.google.com/search?q=laptop&gl=us"
},
"errors": [],
"status_code": 12000,
"task_id": "7513137357520910337"
},
"type": "parsed",
"headers": {},
"status_code": 200,
"query": "laptop",
"task_id": "7513137357520910337",
"created_at": "2026-10-06 07:25:33",
"updated_at": "2026-10-06 07:25:34"
}
]
}
Support
Need help or just want to say hello? Our support is available 24/7.
You can also reach us anytime via email at support@decodo.com.
You can also reach us anytime via email at support@decodo.com.
Feedback
Can’t find what you’re looking for? Request an article!
Have feedback? Share your thoughts on how we can improve.
Have feedback? Share your thoughts on how we can improve.