Google AI Mode API
Access Google's AI-powered search mode with our specialized API. Capture generated answers, follow-up questions, and source links to understand how AI is reshaping search discovery.
Tags: Google API
Parameters
| Name | Required | Type | Default | Description |
|---|---|---|---|---|
| query | Yes | string | The search query for Google Search (e.g., 'coffee shops', 'how to bake a cake'). | |
| html | No | boolean | false | Set to true to return the raw HTML of the Google search results page alongside the structured data. |
| country | No | string | us | Set the target country code (e.g., 'us', 'uk') to localize results. See Google Countries. |
| uule | No | string | Encoded location string (UULE) used to precisely localize Google search results. This is an advanced/technical parameter — if you’re not familiar with it, you can leave it empty and omit it. | |
| location | No | string | The textual location name (e.g., 'New York, NY') to localize the search results. | |
| safe | No | string | off | SafeSearch filter setting. Set to 'active' to filter adult content, or 'off' to disable it. |
Copy Request
bash
curl -X GET "https://api.justserpapi.com/api/v1/google/ai-mode?query=coffee" \
-H "X-API-Key: YOUR_API_KEY"js
const res = await fetch("https://api.justserpapi.com/api/v1/google/ai-mode?query=coffee", {
headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await res.json();
console.log(data);python
import requests
url = "https://api.justserpapi.com/api/v1/google/ai-mode"
headers = { "X-API-Key": "YOUR_API_KEY" }
params = {
"query": "coffee"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())php
<?php
$url = "https://api.justserpapi.com/api/v1/google/ai-mode?query=coffee";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"X-API-Key: YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;go
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
client := &http.Client{}
req, _ := http.NewRequest("GET", "https://api.justserpapi.com/api/v1/google/ai-mode?query=coffee", nil)
req.Header.Set("X-API-Key", "YOUR_API_KEY")
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}Response
Example:
json
{
"code": 200,
"message": "success",
"data": {
"inline_images": [],
"text_blocks": [
{
"type": "paragraph",
"snippet": "Coffee is a globally enjoyed beverage made from roasted beans, categorized primarily by its roast level (light, medium, or dark) and the brewing method used to extract its flavor. Peet's Coffee +1"
},
{
"type": "heading",
"text": "Popular Coffee Bean Recommendations",
"level": 3
},
{
"type": "paragraph",
"snippet": "Expert reviews and user ratings highlight several top-performing beans for different preferences in 2026:"
},
{
"type": "paragraph",
"snippet": "A top-rated choice for espresso lovers, this blend is praised by reviewers on Lavazzausa.com and Amazon for its creamy texture and notes of hazelnut and brown sugar."
},
{
"type": "paragraph",
"snippet": "Recommended by Coffeeness as a top whole-bean option on Amazon, this organic medium-light roast offers a syrupy mouthfeel with caramel and citrus notes."
},
{
"type": "paragraph",
"snippet": "A favorite for those seeking a balanced, \"crafted\" cup, featuring a blend of Latin and Ethiopian beans with a citrusy twist."
},
{
"type": "paragraph",
"snippet": "Marketed as a health-conscious option, this specialty-grade organic coffee is lab-tested for purity and noted for its high antioxidant content."
},
{
"type": "paragraph",
"snippet": "A premium, high-scoring specialty coffee from Hawaii, described by Coffee Review as having a lush, syrupy mouthfeel with complex floral and fruit notes. Coffeeness +5"
},
{
"type": "heading",
"text": "Understanding Coffee Roasts",
"level": 3
},
{
"type": "paragraph",
"snippet": "The roast level significantly impacts the flavor profile and body of the coffee: Peet's Coffee +1"
},
{
"type": "list",
"items": [
{
"type": "list_item",
"snippet": "Light Roast: These beans are light brown and lack surface oil. They retain the most original bean characteristics, often featuring bright, acidic, and floral or fruity notes.",
"links": []
},
{
"type": "list_item",
"snippet": "Medium Roast: Often considered the most balanced, these beans have a medium brown color and offer a mix of sweetness (caramel/chocolate) and moderate acidity.",
"links": []
},
{
"type": "list_item",
"snippet": "Dark Roast: These beans are dark brown to black and often oily. They feature bold, smoky, and bittersweet flavors with low acidity, as the roasting process dominates the original bean characteristics. Hermanos Colombian Coffee Roasters +4 Hermanos Colombian Coffee Roasters +4 Hermanos Colombian Coffee Roasters +4Hermanos Colombian Coffee Roasters +4",
"links": []
}
]
},
{
"type": "heading",
"text": "Common Brewing Methods",
"level": 3
},
{
"type": "paragraph",
"snippet": "The best way to brew often depends on the chosen roast and personal preference for strength and clarity: Coffee By Design +1"
},
{
"type": "list",
"items": [
{
"type": "list_item",
"snippet": "Pour-Over (e.g., Hario V60, Chemex): Best for highlighting complex flavors in light and medium roasts. Experts on CNET and ProCoffeeGear favor it for its clarity and nuance.CNETCNETProCoffeeGearProCoffeeGear",
"links": []
},
{
"type": "list_item",
"snippet": "French Press: A \"full immersion\" method that is very forgiving for beginners. It works well with medium to dark roasts, producing a heavy, rich body.",
"links": []
},
{
"type": "list_item",
"snippet": "Espresso: Uses high pressure to create a concentrated shot. Darker roasts are typically preferred here to ensure the flavor holds up, especially when adding milk.",
"links": []
},
{
"type": "list_item",
"snippet": "Cold Brew: Involves steeping grounds in cold water for 12–24 hours. This results in a smooth, low-acid coffee that pairs exceptionally well with medium to dark roasts. blog.mistobox.com +4 blog.mistobox.com +4 blog.mistobox.com +4blog.mistobox.com +4",
"links": []
}
]
},
{
"type": "paragraph",
"snippet": "Would you like a recommendation for a specific brewing device or more information on specialty coffee regions like Ethiopia or Colombia?"
}
],
"references": [
{
"title": "An Intro to Coffee Roasts | Peet's Coffee. Opens in new tab.",
"link": "https://www.peets.com/blogs/peets/an-intro-to-coffee-roasts#:~:text=Types%20of%20Coffee%20Roasts,roasted%20coffee%20is%20considerably%20weak.",
"snippet": "Dec 11, 2024 — Types of Coffee Roasts. Coffee beans are generally narrowed down to three roast types: light, medium, and dark. During the roastin...",
"source": "Peet's Coffee",
"thumbnail": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
"favicon": "https://www.google.com/s2/favicons?domain=www.peets.com",
"index": 1
},
{
"title": "Coffee Roasts Explained | Coffee Tips & News. Opens in new tab.",
"link": "https://www.stonecreekcoffee.com/blogs/news/coffee-roasts-explained#:~:text=Light%20Roast%20%E2%80%93%20Bright%2C%20acidic%2C,cozy%20late%2Dnight%20diner%20mug.",
"snippet": "Apr 30, 2025 — Coffee Roast Levels 101. There are three main categories of roast: * Light Roast – Bright, acidic, and often fruity. These beans a...",
"source": "Stone Creek Coffee",
"thumbnail": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
"favicon": "https://www.google.com/s2/favicons?domain=www.stonecreekcoffee.com",
"index": 2
},
{
"title": "Comparing Coffee Brewing Methods to Make the Best Cup at Home. Opens in new tab.",
"link": "https://procoffeegear.com/blogs/articles/best-coffee-brewing-methods-home",
"snippet": "May 26, 2025 — Here's how different roast types pair with various brewing methods: * Light Roast: Best suited for pour-over methods like Chemex o...",
"source": "Pro Coffee Gear",
"thumbnail": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
"favicon": "https://www.google.com/s2/favicons?domain=procoffeegear.com",
"index": 3
},
{
"title": "A Guide to Different Coffee Roast Light, Medium, and Dark .... Opens in new tab.",
"link": "https://qavashop.com/en/academy/Post/a-guide-to-different-coffee-roast-light-medium-and-dark-roast-coffee-explained",
"snippet": "Feb 2, 2024 — Key Takeaways * The roast level of coffee beans (light, medium, dark) significantly affects the flavor, color, and caffeine conten...",
"source": "QavaShop",
"thumbnail": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
"favicon": "https://www.google.com/s2/favicons?domain=qavashop.com",
"index": 4
},
{
"title": "Understanding Different Coffee Roasts - A Beginner's Guide. Opens in new tab.",
"link": "https://hermanoscoffeeroasters.com/blogs/blog/understanding-different-coffee-roasts-beginners-guide#:~:text=Why%20We%20Roast-,Roast%20Types,suitable%20for%20the%20espresso%20method.",
"snippet": "May 29, 2021 — * The way coffee is roasted has a huge influence on everything from acidity and bitterness levels to the way the aroma rises. * Th...",
"source": "Hermanos Colombian Coffee Roasters",
"thumbnail": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
"favicon": "https://www.google.com/s2/favicons?domain=hermanoscoffeeroasters.com",
"index": 5
},
{
"title": "Coffee Brewing Methods Compared: How Should You Brew .... Opens in new tab.",
"link": "https://blog.mistobox.com/coffee-brewing-methods-compared/#:~:text=The%20French%20press%20makes%20a,or%20Hario%20v60%20pour%20over).",
"snippet": "Sep 8, 2020 — The French press makes a great cup of coffee and we'd recommend it to anyone looking to make the transition from automatic drip br...",
"source": "blog.mistobox.com",
"thumbnail": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
"favicon": "https://www.google.com/s2/favicons?domain=blog.mistobox.com",
"index": 6
},
{
"title": "Roasts - NCA - About Coffee. Opens in new tab.",
"link": "https://www.aboutcoffee.org/beans/roasts/#:~:text=The%20coffee%20in%20an%20%E2%80%9Cespresso,No%2C%20actually.",
"snippet": "Know your roasts * Coffee roasts fall into one of three color categories: light, medium, and dark. Generally, lighter roasts will ...",
"source": "About Coffee - National Coffee Association",
"thumbnail": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
"favicon": "https://www.google.com/s2/favicons?domain=www.aboutcoffee.org",
"index": 7
},
{
"title": "Best Coffee Beans on Amazon in 2026: My Top 8 Picks. Opens in new tab.",
"link": "https://www.coffeeness.de/en/best-coffee-beans-on-amazon/#:~:text=What%20to%20Consider,Final%20Thoughts",
"snippet": "Mar 28, 2025 — I mean, I wanted to have fun! * At a Glance. * What Are the Best Coffee Beans? * Should You Buy Coffee Beans on Amazon? * Can You ...",
"source": "Coffeeness",
"thumbnail": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
"favicon": "https://www.google.com/s2/favicons?domain=www.coffeeness.de",
"index": 8
},
{
"title": "The Best Coffee Brewing Methods: Tips From a Pro Barista. Opens in new tab.",
"link": "https://www.coffeeness.de/en/coffee-brewing-methods/#:~:text=Differences%20in%20the%20Cup,-Pour%2Dover%20and&text=The%20finished%20coffee%20has%20a,immersion%20coffee%20perfect%20for%20beginners.",
"snippet": "Jan 5, 2024 — Differences in the Cup ... The finished coffee has a completely different mouthfeel and its caffeine content varies too. According...",
"source": "Coffeeness",
"thumbnail": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
"favicon": "https://www.google.com/s2/favicons?domain=www.coffeeness.de",
"index": 9
},
{
"title": "The Different Types of Coffee Roasts and Their Flavor Profiles. Opens in new tab.",
"link": "https://kaffeproducts.com/blogs/blog/the-different-types-of-coffee-roasts-and-their-flavor-profiles#:~:text=Integral%20to%20the%20pleasure%20of,discover%20in%20the%20journey%20ahead.",
"snippet": "Oct 25, 2023 — The Different Types of Coffee Roasts and Their Flavor Profiles * Understanding Coffee Roasting. Photo by Juan Pablo Serrano Arenas...",
"source": "Kaffe Products",
"thumbnail": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
"favicon": "https://www.google.com/s2/favicons?domain=kaffeproducts.com",
"index": 10
},
{
"title": "Brewing Methods - Coffee By Design. Opens in new tab.",
"link": "https://coffeebydesign.com/pages/brewing-methods#:~:text=Many%20have%20more%20than%20one,same%20water%20throughout%20the%20brew.",
"snippet": "Many have more than one favorite—a different brewing method depending on type of coffee, time of day, or even mood! There are coun...",
"source": "Coffee By Design",
"thumbnail": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
"favicon": "https://www.google.com/s2/favicons?domain=coffeebydesign.com",
"index": 11
},
{
"title": "The Surprising Way Most Coffee Professionals Brew Their Morning .... Opens in new tab.",
"link": "https://www.cnet.com/home/kitchen-and-household/best-way-brew-coffee/#:~:text=The%20best%20way%20to%20brew,the%20coffee%20experts%20I%20grilled.&text=While%20it%20wasn't%20completely,forget%2Dit%20kind%20of%20method.&text=Naturally%2C%20pour%2Dover%20is%20the,to%20care%20about%20such%20details.",
"snippet": "Jan 31, 2026 — The best way to brew coffee, according to experts The pour-over method received near-unanimous top ranks from the coffee experts I...",
"source": "CNET",
"thumbnail": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
"favicon": "https://www.google.com/s2/favicons?domain=www.cnet.com",
"index": 12
}
],
"local_results": []
},
"requestId": "a3482a5a-afb2-485e-93be-291202ed94c1",
"timestamp": 1771920437225
}