You.com Retriever

This notebook demonstrates how to use You.com’s Search API as a retriever in LlamaIndex. The API automatically returns relevant web and/or news results based on your query. Visit our docs to learn more about our Search and other APIs: https://docs.you.com/

The retriever converts You.com’s search results into LlamaIndex’s standard format (NodeWithScore), allowing you to:

Use search results as context for LLM queries
Combine with other retrievers (vector stores, databases)
Integrate seamlessly with query engines and agents

Running cells with ‘.venv (Python 3.13.9)’ requires the ipykernel package. You may need to install it into your Python environment.

To get started, install the llama-index-retrievers-you package.

%pip install llama-index-retrievers-you

Setup

Get your API key from the You.com platform

import os
from getpass import getpass

# Set your API key
you_api_key = os.environ.get("YDC_API_KEY") or getpass(
    "Enter your You.com API key: "
)

Basic usage

First, let’s set up the retriever and see what data it returns:

from llama_index.retrievers.you import YouRetriever

retriever = YouRetriever(api_key=you_api_key)
retrieved_results = retriever.retrieve("national parks in the US")

print(f"Retrieved {len(retrieved_results)} results")

for i, result in enumerate(retrieved_results):
    print(f"\nResult {i+1}:")
    print(f"  Text: {result.node.text}...")
    print("Metadata:")
    for key, value in result.node.metadata.items():
        print(f"  {key}: {value}")

Retrieved 10 results

Result 1:
  Text: National monuments, on the other hand, are also frequently protected for their historical or archaeological significance. Eight national parks (including six in Alaska) are paired with a national preserve, areas with different levels of protection that are administered together but considered separate units and whose areas are not included in the figures below.
A bill creating the first national park, Yellowstone, was signed into law by President Ulysses S. Grant in 1872, followed by Mackinac National Park in 1875 (decommissioned in 1895), and then Rock Creek Park (later merged into National Capital Parks), Sequoia and Yosemite in 1890.
Fourteen national parks are designated UNESCO World Heritage Sites (WHS), and 21 national parks are named UNESCO Biosphere Reserves (BR), with eight national parks in both programs. Thirty states have national parks, as do the territories of American Samoa and the U.S.
The state with the most national parks is California with nine, followed by Alaska with eight, Utah with five, and Colorado with four. The largest national park is Wrangell–St. Elias in Alaska: at over 8 million acres (32,375 km2), it is larger than each of the nine smallest states.
Great Smoky Mountains National Park in North Carolina and Tennessee has been the most-visited park since 1944, and had over 12 million visitors in 2024. In contrast, about 11,900 people visited the remote Gates of the Arctic National Park and Preserve in Alaska in 2024. ... The following table includes the 30 states and two territories that have national parks....
Metadata:
  url: https://en.wikipedia.org/wiki/List_of_national_parks_of_the_United_States
  title: List of national parks of the United States - Wikipedia
  description: National monuments, on the other hand, are also frequently protected for their historical or archaeological significance. Eight national parks (including six in Alaska) are paired with a national preserve, areas with different levels of protection that are administered together but considered ...
  page_age: 2025-12-10T05:10:46
  thumbnail_url: https://upload.wikimedia.org/wikipedia/commons/thumb/0/0b/RNS_Yellowstone_13399u.jpg/960px-RNS_Yellowstone_13399u.jpg
  favicon_url: https://you.com/favicon?domain=en.wikipedia.org&size=128
  source_type: web

Result 2:
  Text: Secure .gov websites use HTTPS A lock ( ) or https:// means you've safely connected to the .gov website. Share sensitive information only on official, secure websites. Skip to global NPS navigation · Skip to the main content · Skip to the footer section · National Park Service Search ·
An official website of the United States government ... Official websites use .gov A .gov website belongs to an official government organization in the United States....
Metadata:
  url: https://www.nps.gov/findapark/index.htm
  title: Find a Park (U.S. National Park Service)
  description: Find a national park by selecting from a list or choosing a state on the map.
  favicon_url: https://you.com/favicon?domain=www.nps.gov&size=128
  source_type: web

Result 3:
  Text: Get ideas to help plan your trip to parks across the country based on your interests in nature, history, and fun things to do. ... Follow, share, and be a part of the conversation on official National Park Service social media channels.
As the new year is underway, find suggestions to map your trips to national parks in person and virtually.
Discover America's stories. Plan your visit and explore the diverse landscapes, national parks, and cultural treasures managed by the National Park Service.
An official website of the United States government ... Official websites use .gov A .gov website belongs to an official government organization in the United States....
Metadata:
  url: https://www.nps.gov/
  title: NPS.gov Homepage (U.S. National Park Service)
  description: Secure .gov websites use HTTPS A lock ( ) or https:// means you've safely connected to the .gov website. Share sensitive information only on official, secure websites. ... Celebrate the nation's 250th birthday where history happened—in your national parks!
  page_age: 2025-12-16T00:02:44
  thumbnail_url: https://www.nps.gov/common/commonspot/templates/images/logos/nps_social_image_02.jpg
  favicon_url: https://you.com/favicon?domain=www.nps.gov&size=128
  source_type: web

Result 4:
  Text: I’ve updated this post of all the US National Parks ranked; which now stands at 63. Rankings of course are all subjective. These are all based on my experience and tastes. People will agree or disagree, some will call me a moron, scream and yell-and some will simply add to their unending bucket list. But what myself and all those people have in common is we like lists.
Now here are all the US National Parks ranked backwards from 63 to 1. Tell me what you think of my list and what your top 5-10 would be. Enjoy! I found Hot Springs National Park really boring, uninteresting and I don’t understand why it’s a National Park in the first place.
Something had to be last for the US National Parks ranked. ... Indiana Dunes National Park is a recent addition to the US National Parks ranked list. It’s essentially a marginal beach on a lake with power plants and factories nearby. Plus, if you drive from Chicago, you’ll pay a fortune in tolls and wait in traffic just to enter the park in summer.
There isn’t really much to see in Pinnacles National Park. The drive into the park is better than the park itself. Plus I found it annoying that the 2 sides of the park didn’t connect. I have heard from others that I underrated it so next time I go I may change it for my next US National Parks ranked list....
Metadata:
  url: https://www.leeabbamonte.com/north-america/national-parks/all-63-us-national-parks-ranked.html
  title: All 63 US National Parks Ranked
  description: I’ve updated this post of all the US National Parks ranked; which now stands at 63. Rankings of course are all subjective. These are all based on my experience and tastes. People will agree or disagree, some will call me a moron, scream and yell-and some will simply add to their unending bucket list. But what myself and all those people have in ...
  page_age: 2025-04-09T07:44:13
  thumbnail_url: https://www.leeabbamonte.com/wp-content/uploads/2018/08/image1-16.jpeg
  favicon_url: https://you.com/favicon?domain=www.leeabbamonte.com&size=128
  source_type: web

Result 5:
  Text: Today, 63 designated national parks in the United States draw hundreds of millions of visitors a year to witness jaw-dropping natural wonders and unforgettable terrains. To determine the best U.S. national parks, U.S. News considered scenic beauty, range of activities and the opinions of both travel experts and recent park visitors. Vote for your favorite park below to help us determine next year's ranking.
Considered one of the world's best places to visit, Glacier National Park spans three mountain ranges and includes more than 700 lakes across northwest Montana. Take advantage of the park's expansive hiking trails, and be sure to hit traveler favorites like the Trail of the Cedars and Iceberg Lake Trail.
Other must-dos include a ride along the scenic Going-to-the-Sun Road and a trip to Waterton-Glacier International Peace Park, a UNESCO World Heritage Site on the Canadian border. What's more, Glacier hosts free ranger-led activities like guided hikes and stargazing events ideal for visitors of all ages. Read More ... Even if Yellowstone didn't hold the incredible distinction of being America's first national park, the 2.2 million-acre park, which stretches across Wyoming, Montana and Idaho, could easily stand on its own for its one-of-a-kind natural attractions and magnificent landscapes.
Here, travelers can get lost in the splendor of Yellowstone's many lakes, mountains, bison-filled valleys and, of course, its unmatched hot springs and active geysers (of which the park boasts about half of the world's supply). To avoid the crowds that often plague Yellowstone while also ensuring manageable weather, plan to visit in May or October. Read More ... California's most-visited national park stands out for its bounty of impressive waterfalls, such as Vernal Fall and Bridalveil Fall, as well as its imposing granite rock formations like Half Dome and El Capitan....
Metadata:
  url: https://travel.usnews.com/rankings/best-national-parks-in-the-usa/
  title: 19 Best National Parks to Visit in the U.S. | U.S. News Travel
  description: Today, 63 designated national parks in the United States draw hundreds of millions of visitors a year to witness jaw-dropping natural wonders and unforgettable terrains. To determine the best U.S. national parks, U.S. News considered scenic beauty, range of activities and the opinions of both travel experts and recent park visitors. Vote for your favorite park below to help us ...
  page_age: 2025-04-07T11:18:28
  thumbnail_url: https://travel.usnews.com/dims4/USNEWS/83ca754/2147483647/resize/1200x630&gt;/quality/85/format/webp/?url=https%3A%2F%2Ftravel.usnews.com%2Fimages%2FGetty_-_kwiktor_bzkdUe1.jpg
  favicon_url: https://you.com/favicon?domain=travel.usnews.com&size=128
  source_type: web

Result 6:
  Text: Croix Island International Historic Site, utilized $202,950 in Eastern National (the parent of America’s National Parks) donations to hire seasonal staff and interns, purchase publications and signage, and plan and design tactile... ... New River Gorge National Park & Preserve, Gauley River National Recreation Area, and Bluestone National Scenic River used $35,900 in Eastern National (the parent of America's National Parks™) funds to support its educational programming in 2023.
In 2023, the Canal Exploration Center in Cuyahoga Valley National Park used $5,384 in Eastern National (the parent of America's National Parks™) donations to support several National Park Service (NPS) programs, such as Teacher-Ranger-Teacher.
Our team extends the experiences of park visitors through friendly and engaged customer service. We offer a fun, challenging, and exciting place to work. ... Discover America’s history, culture, and natural wonders with Passport To Your National Parks,® our best-selling national park guidebook. Use your Passport to collect national park cancellation stamps and stickers, and start planning your next expedition!
America’s National Parks™ has awarded a total of $250,000 to 11 National Park Service units through the America’s National Parks™ 250th Grant Program – History Happens Here to support the parks’ efforts in the upcoming celebrations for the 250th Anniversary of the......
Metadata:
  url: https://americasnationalparks.org/
  title: Home - America's National Parks
  description: Croix Island International Historic ... (the parent of America’s National Parks) donations to hire seasonal staff and interns, purchase publications and signage, and plan and design tactile... ... New River Gorge National Park & Preserve, Gauley River National Recreation Area, and Bluestone National Scenic River used $35,900 in ...
  page_age: 2025-02-26T20:35:12
  favicon_url: https://you.com/favicon?domain=americasnationalparks.org&size=128
  source_type: web

Result 7:
  Text: Thirty states and two U.S. territories have a total of 63 national parks. California has the most with nine, followed by Alaska, Utah and Colorado.
Thirty states and two U.S. territories have a total of 63 national parks. ... California has the most with nine, followed by Alaska with eight, Utah with five, and Colorado with four....
Metadata:
  url: https://www.nationalparktrips.com/parks/us-national-parks-by-state-list/
  title: U.S. National Parks by State
  description: The newest national parks are New River Gorge National Park established on Dec. 27, 2020, White Sands National Park was upgraded from a national monument Dec. 20, 2019 and Indiana Dunes which changed its name from “National Lakeshore” to “National Park” on Feb.
  page_age: 2025-06-24T08:28:18
  thumbnail_url: https://www.nationalparktrips.com/wp-content/uploads/2021/01/Lassen-Volcanic-LassenPeak-ManzanitaLake_Dollar_2400.jpg
  favicon_url: https://you.com/favicon?domain=www.nationalparktrips.com&size=128
  source_type: web

Result 8:
  Text: We've teamed up with the National Park Foundation - join the movement to protect our national parks, donate at checkout!...
Metadata:
  url: https://usparkpass.com/list-of-national-parks/
  title: List of National Parks - US Park Pass
  description: Browse through the list of national parks, monuments and battlefields. Sites with entrance or day-use fees are covered by the America the Beautiful National Parks Pass. For the most up-to-date information on fees, please visit NPS.gov
  page_age: 2025-09-30T18:29:55
  favicon_url: https://you.com/favicon?domain=usparkpass.com&size=128
  source_type: web

Result 9:
  Text: Black Canyon of the Gunnison National Park deserves every bit of interest that some of its fellow Colorado parks enjoy.
Big Bend National Park represents arid mountains, canyons, and desert wildlife and has a shared border with Mexico. ... The majority of Biscayne National Park is underwater, but that is the reason to go explore this Florida attraction off the southern tip of the state.
Acadia National Park features a stunning coastline and Cadillac Mountain which is the place where the United States first sees the sunrise.
Arches National Park has over 2,000 naturally created arches and sandstone rock formations as the most beautiful natural attraction of Utah....
Metadata:
  url: https://national-parks.org/united-states/
  title: National Parks in the United StatesUnited States | (Official GANP ...
  description: The GANP is here to help you discover, explore, and learn more about the national parks in United States and why we need to protect them.
  page_age: 2025-10-06T12:48:18
  thumbnail_url: https://national-parks.org/wp-content/uploads/2025/10/Grand-Canyon.jpg
  favicon_url: https://you.com/favicon?domain=national-parks.org&size=128
  source_type: web

Result 10:
  Text: The United States National Park System includes 63 officially designated National Parks, such as Yellowstone, Zion, Yosemite, Grand Canyon, and Great Smoky Mountains, among many others located across the country and its territories. You can see the national parks map below. (You can click the image below to see US national parks map in full size)
Winter temperatures can drop as low as -50°F (-45°C) or even lower. The average temperature in January, the coldest month, ranges from -20°F to -35°F (-29°C to -37°C). ... The U.S. national park that is approximately 95% water is Dry Tortugas National Park · Reference: Bright Standards US National Parks List and Map
US has 63 national parks. These parks are part of the National Park Service, which manages a total of 424 units, including national monuments, historic sites, and other protected areas.
The newest national park in the USA is New River Gorge National Park and Preserve in West Virginia....
Metadata:
  url: https://www.national-park.com/list-of-national-parks-in-the-united-states-2020/
  title: List of National Parks in the United States 2026 and Map
  description: The United States National Park System includes 63 officially designated National Parks, such as Yellowstone, Zion, Yosemite, Grand Canyon, and Great Smoky Mountains, among many others located across the country and its territories. You can see the national parks map below. (You can click the image below to see US ...
  page_age: 2026-01-01T09:25:48
  thumbnail_url: https://www.national-park.com/wp-content/uploads/2024/07/list-of-national-parks-in-the-US.webp
  favicon_url: https://you.com/favicon?domain=www.national-park.com&size=128
  source_type: web

Async usage

The retriever also supports async operations.

from llama_index.retrievers.you import YouRetriever

retriever = YouRetriever(api_key=you_api_key)

# Use aretrieve for async operations
retrieved_results = await retriever.aretrieve("national parks in the US")

print(f"Retrieved {len(retrieved_results)} results asynchronously")

for i, result in enumerate(retrieved_results):
    print(f"\nResult {i+1}:")
    print(f"  Text: {result.node.text}...")
    print("Metadata:")
    for key, value in result.node.metadata.items():
        print(f"  {key}: {value}")

Retrieved 10 results asynchronously

Result 1:
  Text: National monuments, on the other hand, are also frequently protected for their historical or archaeological significance. Eight national parks (including six in Alaska) are paired with a national preserve, areas with different levels of protection that are administered together but considered separate units and whose areas are not included in the figures below.
A bill creating the first national park, Yellowstone, was signed into law by President Ulysses S. Grant in 1872, followed by Mackinac National Park in 1875 (decommissioned in 1895), and then Rock Creek Park (later merged into National Capital Parks), Sequoia and Yosemite in 1890.
Fourteen national parks are designated UNESCO World Heritage Sites (WHS), and 21 national parks are named UNESCO Biosphere Reserves (BR), with eight national parks in both programs. Thirty states have national parks, as do the territories of American Samoa and the U.S.
The state with the most national parks is California with nine, followed by Alaska with eight, Utah with five, and Colorado with four. The largest national park is Wrangell–St. Elias in Alaska: at over 8 million acres (32,375 km2), it is larger than each of the nine smallest states.
Great Smoky Mountains National Park in North Carolina and Tennessee has been the most-visited park since 1944, and had over 12 million visitors in 2024. In contrast, about 11,900 people visited the remote Gates of the Arctic National Park and Preserve in Alaska in 2024. ... The following table includes the 30 states and two territories that have national parks....
Metadata:
  url: https://en.wikipedia.org/wiki/List_of_national_parks_of_the_United_States
  title: List of national parks of the United States - Wikipedia
  description: National monuments, on the other hand, are also frequently protected for their historical or archaeological significance. Eight national parks (including six in Alaska) are paired with a national preserve, areas with different levels of protection that are administered together but considered ...
  page_age: 2025-12-10T05:10:46
  thumbnail_url: https://upload.wikimedia.org/wikipedia/commons/thumb/0/0b/RNS_Yellowstone_13399u.jpg/960px-RNS_Yellowstone_13399u.jpg
  favicon_url: https://you.com/favicon?domain=en.wikipedia.org&size=128
  source_type: web

Result 2:
  Text: Secure .gov websites use HTTPS A lock ( ) or https:// means you've safely connected to the .gov website. Share sensitive information only on official, secure websites. Skip to global NPS navigation · Skip to the main content · Skip to the footer section · National Park Service Search ·
An official website of the United States government ... Official websites use .gov A .gov website belongs to an official government organization in the United States....
Metadata:
  url: https://www.nps.gov/findapark/index.htm
  title: Find a Park (U.S. National Park Service)
  description: Find a national park by selecting from a list or choosing a state on the map.
  favicon_url: https://you.com/favicon?domain=www.nps.gov&size=128
  source_type: web

Result 3:
  Text: Get ideas to help plan your trip to parks across the country based on your interests in nature, history, and fun things to do. ... Follow, share, and be a part of the conversation on official National Park Service social media channels.
As the new year is underway, find suggestions to map your trips to national parks in person and virtually.
Discover America's stories. Plan your visit and explore the diverse landscapes, national parks, and cultural treasures managed by the National Park Service.
An official website of the United States government ... Official websites use .gov A .gov website belongs to an official government organization in the United States....
Metadata:
  url: https://www.nps.gov/
  title: NPS.gov Homepage (U.S. National Park Service)
  description: Secure .gov websites use HTTPS A lock ( ) or https:// means you've safely connected to the .gov website. Share sensitive information only on official, secure websites. ... Celebrate the nation's 250th birthday where history happened—in your national parks!
  page_age: 2025-12-16T00:02:44
  thumbnail_url: https://www.nps.gov/common/commonspot/templates/images/logos/nps_social_image_02.jpg
  favicon_url: https://you.com/favicon?domain=www.nps.gov&size=128
  source_type: web

Result 4:
  Text: I’ve updated this post of all the US National Parks ranked; which now stands at 63. Rankings of course are all subjective. These are all based on my experience and tastes. People will agree or disagree, some will call me a moron, scream and yell-and some will simply add to their unending bucket list. But what myself and all those people have in common is we like lists.
Now here are all the US National Parks ranked backwards from 63 to 1. Tell me what you think of my list and what your top 5-10 would be. Enjoy! I found Hot Springs National Park really boring, uninteresting and I don’t understand why it’s a National Park in the first place.
Something had to be last for the US National Parks ranked. ... Indiana Dunes National Park is a recent addition to the US National Parks ranked list. It’s essentially a marginal beach on a lake with power plants and factories nearby. Plus, if you drive from Chicago, you’ll pay a fortune in tolls and wait in traffic just to enter the park in summer.
There isn’t really much to see in Pinnacles National Park. The drive into the park is better than the park itself. Plus I found it annoying that the 2 sides of the park didn’t connect. I have heard from others that I underrated it so next time I go I may change it for my next US National Parks ranked list....
Metadata:
  url: https://www.leeabbamonte.com/north-america/national-parks/all-63-us-national-parks-ranked.html
  title: All 63 US National Parks Ranked
  description: I’ve updated this post of all the US National Parks ranked; which now stands at 63. Rankings of course are all subjective. These are all based on my experience and tastes. People will agree or disagree, some will call me a moron, scream and yell-and some will simply add to their unending bucket list. But what myself and all those people have in ...
  page_age: 2025-04-09T07:44:13
  thumbnail_url: https://www.leeabbamonte.com/wp-content/uploads/2018/08/image1-16.jpeg
  favicon_url: https://you.com/favicon?domain=www.leeabbamonte.com&size=128
  source_type: web

Result 5:
  Text: Today, 63 designated national parks in the United States draw hundreds of millions of visitors a year to witness jaw-dropping natural wonders and unforgettable terrains. To determine the best U.S. national parks, U.S. News considered scenic beauty, range of activities and the opinions of both travel experts and recent park visitors. Vote for your favorite park below to help us determine next year's ranking.
Considered one of the world's best places to visit, Glacier National Park spans three mountain ranges and includes more than 700 lakes across northwest Montana. Take advantage of the park's expansive hiking trails, and be sure to hit traveler favorites like the Trail of the Cedars and Iceberg Lake Trail.
Other must-dos include a ride along the scenic Going-to-the-Sun Road and a trip to Waterton-Glacier International Peace Park, a UNESCO World Heritage Site on the Canadian border. What's more, Glacier hosts free ranger-led activities like guided hikes and stargazing events ideal for visitors of all ages. Read More ... Even if Yellowstone didn't hold the incredible distinction of being America's first national park, the 2.2 million-acre park, which stretches across Wyoming, Montana and Idaho, could easily stand on its own for its one-of-a-kind natural attractions and magnificent landscapes.
Here, travelers can get lost in the splendor of Yellowstone's many lakes, mountains, bison-filled valleys and, of course, its unmatched hot springs and active geysers (of which the park boasts about half of the world's supply). To avoid the crowds that often plague Yellowstone while also ensuring manageable weather, plan to visit in May or October. Read More ... California's most-visited national park stands out for its bounty of impressive waterfalls, such as Vernal Fall and Bridalveil Fall, as well as its imposing granite rock formations like Half Dome and El Capitan....
Metadata:
  url: https://travel.usnews.com/rankings/best-national-parks-in-the-usa/
  title: 19 Best National Parks to Visit in the U.S. | U.S. News Travel
  description: Today, 63 designated national parks in the United States draw hundreds of millions of visitors a year to witness jaw-dropping natural wonders and unforgettable terrains. To determine the best U.S. national parks, U.S. News considered scenic beauty, range of activities and the opinions of both travel experts and recent park visitors. Vote for your favorite park below to help us ...
  page_age: 2025-04-07T11:18:28
  thumbnail_url: https://travel.usnews.com/dims4/USNEWS/83ca754/2147483647/resize/1200x630&gt;/quality/85/format/webp/?url=https%3A%2F%2Ftravel.usnews.com%2Fimages%2FGetty_-_kwiktor_bzkdUe1.jpg
  favicon_url: https://you.com/favicon?domain=travel.usnews.com&size=128
  source_type: web

Result 6:
  Text: Croix Island International Historic Site, utilized $202,950 in Eastern National (the parent of America’s National Parks) donations to hire seasonal staff and interns, purchase publications and signage, and plan and design tactile... ... New River Gorge National Park & Preserve, Gauley River National Recreation Area, and Bluestone National Scenic River used $35,900 in Eastern National (the parent of America's National Parks™) funds to support its educational programming in 2023.
In 2023, the Canal Exploration Center in Cuyahoga Valley National Park used $5,384 in Eastern National (the parent of America's National Parks™) donations to support several National Park Service (NPS) programs, such as Teacher-Ranger-Teacher.
Our team extends the experiences of park visitors through friendly and engaged customer service. We offer a fun, challenging, and exciting place to work. ... Discover America’s history, culture, and natural wonders with Passport To Your National Parks,® our best-selling national park guidebook. Use your Passport to collect national park cancellation stamps and stickers, and start planning your next expedition!
America’s National Parks™ has awarded a total of $250,000 to 11 National Park Service units through the America’s National Parks™ 250th Grant Program – History Happens Here to support the parks’ efforts in the upcoming celebrations for the 250th Anniversary of the......
Metadata:
  url: https://americasnationalparks.org/
  title: Home - America's National Parks
  description: Croix Island International Historic ... (the parent of America’s National Parks) donations to hire seasonal staff and interns, purchase publications and signage, and plan and design tactile... ... New River Gorge National Park & Preserve, Gauley River National Recreation Area, and Bluestone National Scenic River used $35,900 in ...
  page_age: 2025-02-26T20:35:12
  favicon_url: https://you.com/favicon?domain=americasnationalparks.org&size=128
  source_type: web

Result 7:
  Text: Thirty states and two U.S. territories have a total of 63 national parks. California has the most with nine, followed by Alaska, Utah and Colorado.
Thirty states and two U.S. territories have a total of 63 national parks. ... California has the most with nine, followed by Alaska with eight, Utah with five, and Colorado with four....
Metadata:
  url: https://www.nationalparktrips.com/parks/us-national-parks-by-state-list/
  title: U.S. National Parks by State
  description: The newest national parks are New River Gorge National Park established on Dec. 27, 2020, White Sands National Park was upgraded from a national monument Dec. 20, 2019 and Indiana Dunes which changed its name from “National Lakeshore” to “National Park” on Feb.
  page_age: 2025-06-24T08:28:18
  thumbnail_url: https://www.nationalparktrips.com/wp-content/uploads/2021/01/Lassen-Volcanic-LassenPeak-ManzanitaLake_Dollar_2400.jpg
  favicon_url: https://you.com/favicon?domain=www.nationalparktrips.com&size=128
  source_type: web

Result 8:
  Text: We've teamed up with the National Park Foundation - join the movement to protect our national parks, donate at checkout!...
Metadata:
  url: https://usparkpass.com/list-of-national-parks/
  title: List of National Parks - US Park Pass
  description: Browse through the list of national parks, monuments and battlefields. Sites with entrance or day-use fees are covered by the America the Beautiful National Parks Pass. For the most up-to-date information on fees, please visit NPS.gov
  page_age: 2025-09-30T18:29:55
  favicon_url: https://you.com/favicon?domain=usparkpass.com&size=128
  source_type: web

Result 9:
  Text: Black Canyon of the Gunnison National Park deserves every bit of interest that some of its fellow Colorado parks enjoy.
Big Bend National Park represents arid mountains, canyons, and desert wildlife and has a shared border with Mexico. ... The majority of Biscayne National Park is underwater, but that is the reason to go explore this Florida attraction off the southern tip of the state.
Acadia National Park features a stunning coastline and Cadillac Mountain which is the place where the United States first sees the sunrise.
Arches National Park has over 2,000 naturally created arches and sandstone rock formations as the most beautiful natural attraction of Utah....
Metadata:
  url: https://national-parks.org/united-states/
  title: National Parks in the United StatesUnited States | (Official GANP ...
  description: The GANP is here to help you discover, explore, and learn more about the national parks in United States and why we need to protect them.
  page_age: 2025-10-06T12:48:18
  thumbnail_url: https://national-parks.org/wp-content/uploads/2025/10/Grand-Canyon.jpg
  favicon_url: https://you.com/favicon?domain=national-parks.org&size=128
  source_type: web

Result 10:
  Text: The United States National Park System includes 63 officially designated National Parks, such as Yellowstone, Zion, Yosemite, Grand Canyon, and Great Smoky Mountains, among many others located across the country and its territories. You can see the national parks map below. (You can click the image below to see US national parks map in full size)
Winter temperatures can drop as low as -50°F (-45°C) or even lower. The average temperature in January, the coldest month, ranges from -20°F to -35°F (-29°C to -37°C). ... The U.S. national park that is approximately 95% water is Dry Tortugas National Park · Reference: Bright Standards US National Parks List and Map
US has 63 national parks. These parks are part of the National Park Service, which manages a total of 424 units, including national monuments, historic sites, and other protected areas.
The newest national park in the USA is New River Gorge National Park and Preserve in West Virginia....
Metadata:
  url: https://www.national-park.com/list-of-national-parks-in-the-united-states-2020/
  title: List of National Parks in the United States 2026 and Map
  description: The United States National Park System includes 63 officially designated National Parks, such as Yellowstone, Zion, Yosemite, Grand Canyon, and Great Smoky Mountains, among many others located across the country and its territories. You can see the national parks map below. (You can click the image below to see US ...
  page_age: 2026-01-01T09:25:48
  thumbnail_url: https://www.national-park.com/wp-content/uploads/2024/07/list-of-national-parks-in-the-US.webp
  favicon_url: https://you.com/favicon?domain=www.national-park.com&size=128
  source_type: web

Getting the latest news

The You.com API can also news results automatically, based on your query.

# News-related queries will include news results in the response
from typing import Any

# You should see at most 5 results per type - news and web
# Notice the source_type: "news" or "web"
retriever = YouRetriever(api_key=you_api_key, count=5, country="IN")

retrieved_results = retriever.retrieve(
    "What are the latest geopolitical updates in India"
)

print(f"Retrieved {len(retrieved_results)} results")
for i, result in enumerate[Any](retrieved_results):
    print(f"\nResult {i+1}:")
    print(f"  Text: {result.node.text}...")
    print("Metadata:")
    for key, value in result.node.metadata.items():
        print(f"  {key}: {value}")

Retrieved 10 results

Result 1:
  Text: This surge, driven by safe-haven demand amidst global geopolitical tensions, marks significant gains for both precious metals. Investors are now keenly awaiting US inflation data for future market direction. Silver rises to Rs 2.55L/kg; gold at Rs 1.445L per 10g ... Stock market outlook: Q3 earnings, inflation data in focus this week; global cues to steer sentiment ... Indian equity markets brace for an event-packed week, with the December quarter earnings season kicking off and key inflation data releases from India and the US on the horizon.
Stock market today: Which are the top 10 losers and gainers on NSE, BSE on January 12? Check list ... WEF Davos 2026: Donald Trump to attend summit with largest-ever US delegation; strong Indian side also expected ... US President Donald Trump will lead a large delegation to the World Economic Forum in Davos, Switzerland, starting January 18. Global leaders will convene amidst rising geopolitical tensions and economic uncertainty, with a focus on Ukraine, Gaza, and Latin America.
Gold and silver prices are poised for volatility this week, driven by crucial US economic data and escalating geopolitical tensions following the reported capture of Venezuela's President Maduro. Analysts anticipate aggressive trading as markets digest the fallout, with potential impacts on bullion and crude oil. Despite recent corrections, underlying safe-haven demand persists. Indian High Commissioner meets Kenya's Prime Cabinet Secretary; sides agree to convene Joint Commission for Cooperation
The Indian rupee opened lower against the US dollar, impacted by rising crude oil prices and foreign investor outflows. Geopolitical tensions and potential US tariffs are prompting a sell-off in domestic equities....
Metadata:
  url: https://timesofindia.indiatimes.com/topic/geopolitics/news
  title: Geopolitics News | Latest News on Geopolitics - Times of India
  description: Check out for the latest news on geopolitics along with geopolitics live news at Times of India
  thumbnail_url: https://static.toiimg.com/photo/47529300.cms
  favicon_url: https://you.com/favicon?domain=timesofindia.indiatimes.com&size=128
  source_type: web

Result 2:
  Text: Precious and industrial metals are surging to record highs as the year ends, driven by economic and geopolitical uncertainty, robust industrial demand and, in some cases, tight supply. Amid continued domestic unrest and strained geopolitical ties, Russia has called on Bangladesh to ease tensions with India at the earliest
For both, itll have to be about the actual numbers, too. Russian President Vladimir Putin's high-profile visit to New Delhi has reignited debate in Washington over India's growing proximity to Moscow, at a time when global geopolitical alignments are shifting rapidly.
As Iran's clerical leadership struggles to contain protests fuelled by economic hardship and political fatigue, India is watching events unfold with quiet unease. Bitcoin held near the $95,000 level after softer US inflation data improved risk appetite across global markets. Analysts said easing price pressures and rising geopolitical tensions boosted demand for alternative assets.
A Danish intelligence agency has for the first time described the US as a potential security risk, signalling a shift in the Nordic country's view of its close ally amid geopolitical frictions over Greenland. Pakistan is trying to challenge India's long-standing dominance in South Asian geopolitics with a new proposal to alter regional alliances....
Metadata:
  url: https://www.ndtv.com/topic/geopolitical
  title: Geopolitical: Latest News, Photos, Videos on Geopolitical - NDTV.COM
  description: Find Geopolitical Latest News, Videos & Pictures on Geopolitical and see latest updates, news, information from NDTV.COM. Explore more on Geopolitical.
  thumbnail_url: https://cdn.ndtv.com/common/images/ogndtv.png
  favicon_url: https://you.com/favicon?domain=www.ndtv.com&size=128
  source_type: web

Result 3:
  Text: The Weekly Rundown: U.S.-Saudi Meeting, Military Escalation in the Caribbean · AssessmentsNov 11, 2025 · Back-to-Back Blasts in India and Pakistan Raise Fears of Another Escalation · SnapshotsOct 16, 2025 · India and Canada's Diplomatic Reset: Opportunities and Challenges · On GeopoliticsOct 7, 2025 ·
U.S. Tariffs Strain India's Exports Amid Stalled Trade Talks...
Metadata:
  url: https://worldview.stratfor.com/region/south-asia/india
  title: India - Geopolitics, Analysis and News
  description: Profile · Notifications · Sign Out · Articles · India · FILTER: · Select · SORT:
  favicon_url: https://you.com/favicon?domain=worldview.stratfor.com&size=128
  source_type: web

Result 4:
  Text: India's silent stance on Israel-Gaza and Israel-Iran conflicts threatens to reduce geopolitical influence.
Regional conflicts: Ukraine war, West Asia tensions and Indo-Pacific militarization are increasing pressure on global governance. Economic nationalism: Supply chain fragmentation, technology restrictions and protectionism. US imposing high import duties on various countries. Pakistan based terrorist groups involved in Pahalgam attack declared as terrorists by UN (April 22, 2025). India’s decisive military retaliation received mixed global reactions.
However, Indian Parliament completely rejected Trump’s claim.
US imposes 25% tariff on Indian goods on the day of India-US NISAR satellite launch....
Metadata:
  url: https://www.sanskritiias.com/current-affairs/indias-position-in-the-current-global-geopolitical-scenario
  title: India's Position in the Current Global Geopolitical Scenario - ...
  description: Global geopolitics is changing and traditional power alignments are changing due to conflicts, economic instability and changing alliances. India needs to deal with these changes to safeguard its interests.
  thumbnail_url: https://www.sanskritiias.com/frontview/assets/images/sanskriti-logo.png
  favicon_url: https://you.com/favicon?domain=www.sanskritiias.com&size=128
  source_type: web

Result 5:
  Text: This surge is driven by geopolitical tensions and robust industrial demand. Experts predict further price increases if tensions escalate. While physical demand has seen a dip, the outlook for silver remains bullish. Investors are advised to accumulate on dips. A significant deficit in silver supply is also projected.19 Jan, 2026, 11:55 PM IST · Central banks, led by India and China, are significantly reducing US Treasury holdings and increasing gold reserves.
Geopolitical tensions eased, impacting commodity-linked shares. Defence stocks provided some support. Novo Nordisk shares surged on positive news about its weight-loss pill. Investors are navigating a busy earnings season amidst global uncertainties.17 Jan, 2026, 11:05 AM IST · In a vibrant trading session on Friday, Indian stock markets rallied, with Nifty and Sensex recording notable gains.
Investors anticipate a strong corporate earnings season to sustain the U.S. stock market rally amidst policy proposals and geopolitical tensions. Key companies like Netflix, J&J, and Intel are set to release Q4 results, with expectations high for earnings growth in 2026. The market is also watching for Supreme Court rulings on tariffs and Fed independence.17 Jan, 2026, 09:21 AM IST · India navigates a complex energy landscape.
US actions in Venezuela highlight global energy market volatility. India, reliant on imported energy, seeks affordable supplies while managing sanctions and geopolitical pressures. Diversification, strategic reserves, and flexible diplomacy are key....
Metadata:
  url: https://economictimes.indiatimes.com/topic/geopolitics
  title: geopolitics: Latest News & Videos, Photos about geopolitics | The ...
  description: geopolitics Latest Breaking News, Pictures, Videos, and Special Reports from The Economic Times. geopolitics Blogs, Comments and Archive News on Economictimes.com
  thumbnail_url: https://img.etimg.com/thumb/msid-65498029,width-672,resizemode-4/et-logo.jpg
  favicon_url: https://you.com/favicon?domain=economictimes.indiatimes.com&size=128
  source_type: web

Result 6:
  Text: Amid geopolitical upheaval, IAF chief's stark warning with a Venezuela, Iran example...
Metadata:
  url: https://www.moneycontrol.com/defence/amid-geopolitical-upheaval-iaf-chief-s-stark-warning-with-a-venezuela-iran-example-article-13783238.html
  title: Amid geopolitical upheaval, IAF chief's stark warning with a Venezuela, Iran example
  description: Amid geopolitical upheaval, IAF chief's stark warning with a Venezuela, Iran example
  page_age: 2026-01-21T08:11:10
  thumbnail_url: https://images.moneycontrol.com/static-mcnews/2025/05/20250529102059_Air-Chief-Marshal-Amar-Preet-Singh.jpg
  source_type: news

Result 7:
  Text: The Union Budget for FY26-27 is set to emphasize infrastructure spending and structural reforms, despite global geopolitical challenges and trade tensions....
Metadata:
  url: https://www.newsbytesapp.com/news/business/will-infrastructure-spending-be-a-focus-in-budget-2026/story
  title: Budget 2026: Infrastructure spending and structural reforms to get focus
  description: The Union Budget for FY26-27 is set to emphasize infrastructure spending and structural reforms, despite global geopolitical challenges and trade tensions.
  page_age: 2026-01-21T11:51:07
  thumbnail_url: https://i.cdn.newsbytesapp.com/images/l86920260121164333.jpeg
  source_type: news

Result 8:
  Text: Amid the International Cricket Councils probable nod to Bangladesh Cricket Boards demands for the T20 World Cup venue shift, the Sri Lankan Cricket Board remains on alert for hosting multiple matches....
Metadata:
  url: https://www.mykhel.com/cricket/sri-lanka-open-to-hosting-bangladeshs-t20-world-cup-2026-matches-logistics-remain-concern-exclus-404926.html
  title: Sri Lanka Open to Hosting Bangladesh's T20 World Cup 2026 Matches, Logistics remain Concern | Exclusive
  description: Amid the International Cricket Councils probable nod to Bangladesh Cricket Boards demands for the T20 World Cup venue shift, the Sri Lankan Cricket Board remains on alert for hosting multiple matches.
  page_age: 2026-01-04T17:53:12
  thumbnail_url: https://images.mykhel.com/img/2026/01/colombo-stadium-1767543053.jpg
  source_type: news

Result 9:
  Text: Rediff News - Delivers most trusted news from India and around the world. Impeccable coverage on society, politics, business, sports and entertainment. Top stories, Editorial columns, discussions, interviews and more....
Metadata:
  url: https://www.rediff.com/news
  title: Latest India News, Headlines, Stories and Videos | Rediff.com
  description: Rediff News - Delivers most trusted news from India and around the world. Impeccable coverage on society, politics, business, sports and entertainment. Top stories, Editorial columns, discussions, interviews and more.
  page_age: 2026-01-21T15:40:59
  thumbnail_url: https://im.rediff.com/worldrediff/pix/rediff_icon_red.png
  source_type: news

Result 10:
  Text: The retail business is facing a slow down in sales, which has pushed brokerages to cut down on target price....
Metadata:
  url: https://www.cnbc.com/2026/01/21/india-reliance-oil-russia-trump-tariff-sanctions-retail-slowdown.html
  title: India’s largest company is caught in geopolitical tensions. But it faces the biggest challenge at home
  description: The retail business is facing a slow down in sales, which has pushed brokerages to cut down on target price.
  page_age: 2026-01-21T02:56:04
  thumbnail_url: https://image.cnbcfm.com/api/v1/image/107081542-1656391556758-gettyimages-1240850162-logos.jpeg?v=1656391648&w=1920&h=1080
  source_type: news

Customizing Search Parameters

You can customize the search with optional parameters:

retriever = YouRetriever(
    api_key=you_api_key,
    count=20,  # Return up to 20 results per section (web/news)
    country="US",  # Focus on US results
    language="en",  # English results
    freshness="week",  # Results from the past week
    safesearch="moderate",  # Moderate safe search filtering
)

retrieved_results = retriever.retrieve("renewable energy breakthroughs")

print(f"Retrieved {len(retrieved_results)} recent results from the US")
for i, result in enumerate(retrieved_results):
    print(f"\nResult {i+1}:")
    print(f"  Text: {result.node.text}...")
    print("Metadata:")
    for key, value in result.node.metadata.items():
        print(f"  {key}: {value}")

Retrieved 20 recent results from the US

Result 1:
  Text: Efficiency Breakthrough: Perovskite-silicon tandem solar cells achieving 34.6% efficiency represent a 57% improvement over traditional silicon panels, marking the most significant solar technology advancement in decades and positioning solar as the dominant renewable energy source.
The renewable energy sector is experiencing an unprecedented wave of innovation in 2025, with renewable energy innovations driving the global transition toward a carbon-free future. Currently generating 33% of global electricity, renewable sources are projected to capture a $3.6 trillion market by 2030. To achieve the critical 95% emissions reduction needed for climate goals, breakthrough technologies across solar, wind, storage, and grid integration are reshaping how we generate, store, and distribute clean energy.
Solar technology continues to lead renewable energy innovations with revolutionary advances that dramatically improve efficiency and expand deployment possibilities. The most significant breakthrough in solar technology involves perovskite-silicon tandem cells, which stack two different photovoltaic materials to capture a broader spectrum of sunlight.
The renewable energy innovations emerging in 2025 represent a transformational moment in the global energy transition. From 34.6%-efficient perovskite solar cells to floating offshore wind farms accessing deep-water resources, these breakthrough technologies are making clean energy more efficient, affordable, and accessible than ever before....
Metadata:
  url: https://solartechonline.com/blog/renewable-energy-innovations-2025/
  title: Renewable Energy Innovations 2025: 25+ Breakthrough Technologies
  description: Discover the latest renewable energy innovations revolutionizing solar, wind, storage, and grid technologies. Expert analysis of 25+ breakthrough clean energy solutions.
  page_age: 2026-01-15T16:11:41
  favicon_url: https://you.com/favicon?domain=solartechonline.com&size=128
  source_type: web

Result 2:
  Text: The journal Science has named the growth of renewable energy as the 2025 scientific breakthrough of the year. The reasoning is based on renewable energy surpassing coal as a power source globally this year.
China's exports of renewable technology are also transforming the rest of the world. Europe is a long-standing customer, but countries in the Global South are now also buying solar panels, batteries, and wind turbines at a rapid pace. In Pakistan, imports of Chinese solar panels increased fivefold from 2022 to 2024 when the Ukraine war drove up natural gas prices. According to Lauri Myllyvirta, an analyst at the Centre for Research on Energy and Clean Air, the choice was simple for people who worried about how to keep the lights on in their homes.
Now the real driver is self-interest: lower cost and greater energy security. Hannah Ritchie, a data scientist at the University of Oxford, notes that the long-awaited decline of fossil fuels is now within sight thanks to renewable energy.
Previously, renewable energy had an aura of virtue. Buyers paid more than for fossil energy due to climate concerns....
Metadata:
  url: https://www.warpnews.org/green-tech/renewable-energy-is-the-scientific-breakthrough-of-the-year-surpasses-coal-as-power-source-worldwide/
  title: ☀️ Renewable energy is the scientific breakthrough of the year ...
  description: The journal Science has named the advance of renewable energy as the breakthrough of the year after solar and wind power surpassed coal as a power source globally. In 2004, it took a full year to install 1 gigawatt of solar power capacity globally – today twice that amount goes online every day.
  page_age: 2026-01-17T10:41:39
  thumbnail_url: https://www.warpnews.org/content/images/size/w1200/2026/01/--rets-genombrott-2025-sol-cover.jpg
  favicon_url: https://you.com/favicon?domain=www.warpnews.org&size=128
  source_type: web

Result 3:
  Text: Trump and his energy secretary, Chris Wright, often speak of American energy dominance, but they are crippling American firms’ ability to deploy and build the cheapest sources of electricity in the history of this planet, in favor of a combination of long-in-the-tooth arguments about fossil inevitability and long-shot bets on small modular nuclear reactors and, yes, fusion. Even among billionaires who don’t share Trump’s belief that climate change is a hoax, this latter affinity for far-out, breakthrough technologies has long been a hallmark of American climate investment and philanthropy.
And at the scale and pace that China is producing them, plenty of things stand to be swept away—including, quite possibly, the once seemingly intractable problems of energy poverty and fossil-fuel dependence. In 2024, the total installed electricity capacity of the planet—every coal, gas, hydro, and nuclear plant and all of the renewables—was about 10 terawatts.
Globally, the glut of solar has lowered the average cost of generating electricity to 4 cents a kilowatt hour—perhaps the cheapest form of energy ever. By now, major headlines have begun to catch on to the reality that China’s renewable energy revolution is one of the biggest stories in the world, while Donald Trump’s anti-renewable vision of American energy dominance is a backward sideshow by comparison.
At the start of 2025—in an attempt to rein in the renewables sector—Beijing announced that it would discontinue a long-standing policy that had effectively propped up renewable energy prices, pegging them to that of the “baseline” coal power in each province....
Metadata:
  url: https://www.wired.com/story/china-renewable-energy-revolution/
  title: China’s Renewable Energy Revolution Is a Huge Mess That Might ...
  description: A global onslaught of cheap Chinese green power is upending everything in its path. No one is ready for its repercussions.
  page_age: 2026-01-20T11:00:00
  thumbnail_url: https://media.wired.com/photos/696065a33b2a5521795d41d1/191:100/w_1280,c_limit/China-renewables-web.jpg
  favicon_url: https://you.com/favicon?domain=www.wired.com&size=128
  source_type: web

Result 4:
  Text: Poland's renewable energy industry considers that the revised rules for connecting to the grid in the draft amendment to the energy law ignore project financing realities and may block development, eliminating private investors.
The Government of Andhra Pradesh has given the go-ahead to Websol Energy System Ltd’s (BOM:517498) plans to build a 4-GW greenfield solar cell and solar module factory in the state. ... Renewables Now is a leading business news source for renewable energy professionals globally.
Anaergia Inc (TSX:ANRG), an organic waste to renewable energy specialist, remains committed to a capital-light, “develop-and-transfer” operating model as it seeks to scale its global presence....
Metadata:
  url: https://renewablesnow.com/
  title: Global Renewable Energy News and Trends | Renewables Now
  description: Renewables Now delivers the latest news, expert views and in-depth analysis on key topics for the renewable energy industry and the energy transition.
  page_age: 2026-01-19T03:12:00
  thumbnail_url: http://cdn.renewablesnow.com/images/renewables_now_logo.png
  favicon_url: https://you.com/favicon?domain=renewablesnow.com&size=128
  source_type: web

Result 5:
  Text: Engineers have unlocked a new class of supercapacitor material that could rival traditional batteries in energy while charging dramatically faster. By redesigning carbon structures into highly curved, accessible graphene networks, the team achieved record energy and power densities—enough to reshape electric transport, stabilize power grids, and supercharge consumer electronics.
Aug. 16, 2022  Clean and efficient energy storage technologies are essential to establishing a renewable energy infrastructure.
The project received support from the Australian Research Council and the US Air Force Office of Sponsored Research and aligns with Monash University's broader goal of advancing materials for a low-carbon energy future. ... Materials provided by Monash University. Note: Content may be edited for style and length. ... Petar Jovanović, Meysam Sharifzadeh Mirshekarloo, Phillip Aitchison, Mahdokht Shaibani, Mainak Majumder. Operando interlayer expansion of multiscale curved graphene for volumetrically-efficient supercapacitors. Nature Communications, 2025; 16 (1) DOI: 10.1038/s41467-025-63485-0 ... Monash University. "New graphene breakthrough supercharges energy storage."
Monash University. (2025, December 1). New graphene breakthrough supercharges energy storage. ScienceDaily....
Metadata:
  url: https://www.sciencedaily.com/releases/2025/11/251130205509.htm
  title: New graphene breakthrough supercharges energy storage | ScienceDaily
  description: Engineers have unlocked a new class of supercapacitor material that could rival traditional batteries in energy while charging dramatically faster. By redesigning carbon structures into highly curved, accessible graphene networks, the team achieved record energy and power densities—enough ...
  page_age: 2026-01-17T16:14:25
  thumbnail_url: https://www.sciencedaily.com/images/1920/graphene-energy-storage.webp
  favicon_url: https://you.com/favicon?domain=www.sciencedaily.com&size=128
  source_type: web

Result 6:
  Text: Nature Reviews Clean Technology - The importance of renewable integration into grids came to the forefront in 2025. New challenges in stability, storage, artificial intelligence demand and policy...
Global renewable electricity generation was greater than coal generation for the first time1. Investment and research into long-duration energy storage technology have become key to global grid decarbonization projects4.
The author thanks the Alfred P. Sloan Foundation and ClimateWorks Foundation for the support of research at the Deep Energy and Climate Policy Lab. Marxe School of Public and International Affairs, Baruch College, City University of New York, New York, NY, USA ... Earth and Environmental Sciences, The Graduate Center, City University of New York, New York, NY, USA ... Correspondence to Gang He (何钢). The author declares no competing interests. ... He, G. Renewable integration and AI demand reshaped power grids in 2025.
Dowling, J. A. et al. Role of long-duration energy storage in variable renewable electricity systems....
Metadata:
  url: https://www.nature.com/articles/s44359-025-00136-z
  title: Renewable integration and AI demand reshaped power grids in 2025 ...
  description: The importance of renewable integration into grids came to the forefront in 2025. New challenges in stability, storage, artificial intelligence demand and policy changes defined a year that tested whether power systems can become reliable, flexible and equitable in a net-zero world.
  page_age: 2026-01-20T00:00:00
  thumbnail_url: https://media.springernature.com/m685/springer-static/image/art%3A10.1038%2Fs44359-025-00136-z/MediaObjects/44359_2025_136_Figa_HTML.png
  favicon_url: https://you.com/favicon?domain=www.nature.com&size=128
  source_type: web

Result 7:
  Text: Renewable energy (also called green energy) is energy made from renewable natural resources that are replenished on a human timescale. The most widely used renewable energy types are solar energy, wind power, and hydropower. Bioenergy and geothermal power are also significant in some countries.
Renewable energy installations can be large or small and are suited for both urban and rural areas. Renewable energy is often deployed together with further electrification. This has several benefits: electricity can move heat and vehicles efficiently and is clean at the point of consumption.
Renewable energy systems have rapidly become more efficient and cheaper over the past 30 years. A large majority of worldwide newly installed worldwide electricity capacity is now renewable. Renewable energy sources, such as solar and wind power, have seen significant cost reductions over the past decade, making them more competitive with traditional fossil fuels.
Power from the sun and wind accounted for most of this increase, growing from a combined 2% to 10%. Use of fossil energy shrank from 68% to 62%. In 2024, renewables accounted for over 30% of global electricity generation and are projected to reach over 45% by 2030....
Metadata:
  url: https://en.wikipedia.org/wiki/Renewable_energy
  title: Renewable energy - Wikipedia
  description: These technologies are not yet widely demonstrated or have limited commercialization. Some may have potential comparable to other renewable energy technologies, but still depend on further breakthroughs from research, development and engineering.
  page_age: 2026-01-19T23:01:04
  thumbnail_url: https://upload.wikimedia.org/wikipedia/commons/thumb/4/4d/Andasol_Guadix_4.jpg/1280px-Andasol_Guadix_4.jpg
  favicon_url: https://you.com/favicon?domain=en.wikipedia.org&size=128
  source_type: web

Result 8:
  Text: According to data from the US Energy Information Administration, renewable energy accounted for 8.4% of total primary energy production and 21% of total utility-scale electricity generation in the United States in 2022. Since 2019, wind power has been the largest producer of renewable electricity ...
The development of renewable energy and energy efficiency marked "a new era of energy exploration" in the United States, according to President Barack Obama in 2009. In a joint address to the Congress on February 24, 2009, President Obama called for doubling renewable energy within the following three years.
Renewable energy reached a major milestone in the first quarter of 2011, when it contributed 11.7% of total national energy production (660 TWh), surpassing energy production from nuclear power (620 TWh) for the first time since 1997.
In his 2012 State of the Union address, President Barack Obama restated his commitment to renewable energy and mentioned the long-standing Interior Department commitment to permit 10 GW of renewable energy projects on public land in 2012. Under President Joe Biden, Congress increased that goal to 25 GW by 2025.
Renewable energy technologies encompass a broad, diverse array of technologies, including solar photovoltaics, solar thermal power plants and heating/cooling systems, wind farms, hydroelectricity, geothermal power plants, and ocean power systems and the use of biomass....
Metadata:
  url: https://en.wikipedia.org/wiki/Renewable_energy_in_the_United_States
  title: Renewable energy in the United States - Wikipedia
  description: According to data from the US Energy Information Administration, renewable energy accounted for 8.4% of total primary energy production and 21% of total utility-scale electricity generation in the United States in 2022.
  page_age: 2026-01-16T16:32:47
  thumbnail_url: https://upload.wikimedia.org/wikipedia/commons/thumb/1/12/Map_of_major_renewable_energy_resource_in_the_contiguous_United_States.jpg/1280px-Map_of_major_renewable_energy_resource_in_the_contiguous_United_States.jpg
  favicon_url: https://you.com/favicon?domain=en.wikipedia.org&size=128
  source_type: web

Result 9:
  Text: Our Powering up for net zero article series explores how innovative technologies and solutions – such as smart grid technologies, distributed energy generation, energy storage, and energy parks – can work in tandem with the major grid infrastructure reinforcements underway to meet growing energy demands. See the other articles in this series so far: ... The transition to renewables has accelerated rapidly in the UK, with offshore wind, solar, and hydropower now a growing share of our energy mix.
Battery Energy Storage Systems (BESS) and long-duration storage technologies are an important link in a truly decarbonised energy system. They transform intermittent renewable generation into a dependable, 24/7 energy resource, bridging the gap between variable supply and constant demand.
By capturing excess energy and releasing it during peak hours, storage systems can reduce curtailment, cut carbon emissions, and lower system costs, helping the UK make better use of its clean energy resources. Renewable energy sources such as wind, solar, and hydropower are crucial for decarbonisation, but they are inherently variable.
But as these plants are phased out, the grid is becoming more exposed to the variability of renewable generation. The UK grid has already faced such pressures, and similar incidents across Europe highlight the importance of both energy storage and flexible generation....
Metadata:
  url: https://www.slrconsulting.com/insights/energy-storage-unlocking-renewable-energy-potential/
  title: Unlocking the full potential of renewable energy with energy storage
  description: Our Powering up for net zero article ... the major grid infrastructure reinforcements underway to meet growing energy demands. See the other articles in this series so far: ... The transition to renewables has accelerated rapidly in the UK, with offshore wind, solar, and hydropower ...
  page_age: 2026-01-15T09:30:19
  thumbnail_url: https://cdn.sanity.io/images/b0ecix6u/production/bf53d292aa531441f019a5413c63eb55056709d2-5272x3948.jpg?w=1200
  favicon_url: https://you.com/favicon?domain=www.slrconsulting.com&size=128
  source_type: web

Result 10:
  Text: The announcement comes after Australia set a record for solar energy generation last year, becoming responsible for more than 12 per cent of the nation's power, and after more than 4.2 million households installed rooftop solar panels. The researchers, from UNSW's School of Photovoltaic and Renewable Energy Engineering, investigated ways to boost the efficiency of a material called antimony chalcogenide that has been tipped for use in future solar technology.
Further breakthroughs could be used in the university's spin-off company, Sydney Solar, which is developing transparent solar stickers that promise to generate energy from windows.
The material is abundant and inexpensive to use, is more stable than other candidates, and can be deployed in a layer much thinner than a human hair to improve energy efficiency....
Metadata:
  url: https://www.cootamundraherald.com.au/story/9157416/stacking-solar-cells-could-deliver-cheaper-power/
  title: Stacking solar cells could deliver cheaper power | Cootamundra ...
  description: A material touted as a candidate for next-generation solar technology is showing more promise, with Australian scientists behind...
  page_age: 2026-01-20T19:02:00
  thumbnail_url: https://www.cootamundraherald.com.au/images/transform/v1/crop/frm/silverstone-feed-data/450eebf9-1c9e-4ba4-a74f-4e8cbbe500f9.jpg/r0_90_800_510_w1200_h630_fmax.jpg
  favicon_url: https://you.com/favicon?domain=www.cootamundraherald.com.au&size=128
  source_type: web

Result 11:
  Text: These technological developments have been reinforced by evolving blending mandates and renewable fuel policies in major markets, including Brazil, the European Union, and emerging aviation and marine fuel sectors. Collectively, these changes explain the surge in investment and capacity expansion observed globally and signal a transition of ethanol from a compliance fuel towards a strategically optimised, low-carbon energy carrier.
Recent advances in biofuel technology include improved enzymes, higher-yield crops and processes that use crop residues to boost yields. These developments, alongside renewable energy and carbon-reduction efforts, are strengthening collaboration in the sector.
Emerging trends and market effects - Laws mandating increased ethanol consumption More countries, economic groups, and states are opening their energy systems to biofuels. Brazil has approved a law increasing ethanol content in petrol from 27.5% to 35% [12]. Biodiesel is rising from 15% to 25%. The most significant change is in aviation, with a 1% blend starting in 2027, rising to 10% in 2037 and increasing by 1% annually thereafter. In Europe, the EU is finalising its ethanol blending policies, with a 2030 target of 5.5% renewable fuel [13]. In the US, there is no mandatory ethanol percentage, although financial regulations such as waivers influence consumer behaviour [14]. The transition from E10 to E15, along with expanded availability, further demonstrates growing demand.
One method for distilleries to offset their environmental footprint is through government carbon credits. These credits were once considered unattainable due to gas emissions. However, in 2024, the first ethanol plant voluntarily entered carbon markets [4]. Red Trail Energy laid the groundwork for future facilities....
Metadata:
  url: https://biofuels-news.com/news/driving-forces-and-breakthroughs-in-biofuel-innovation-in-last-three-years/
  title: Driving forces and breakthroughs in biofuel innovation in last ...
  description: These technological developments ... and renewable fuel policies in major markets, including Brazil, the European Union, and emerging aviation and marine fuel sectors. Collectively, these changes explain the surge in investment and capacity expansion observed globally and signal a transition of ethanol from a compliance fuel towards a strategically optimised, low-carbon energy ...
  page_age: 2026-01-20T00:00:00
  thumbnail_url: https://biofuels-news.com/wp-content/uploads/2026/01/Corn-413093161-768x689.jpg
  favicon_url: https://you.com/favicon?domain=biofuels-news.com&size=128
  source_type: web

Result 12:
  Text: This is expected to be the year of accelerated growth in renewable energy adoption and investments globally, driven by falling costs, advancements in battery and storage technology, smart grids, increased finance, and favourable regulations in many countries around the world.
Renewable Energy Costs To Fall Further. Yes, the cost of investing in renewable energy projects will continue its downward trend this year. Notably, wind and solar power will go further lower as cost competitiveness remains the defining characteristic of renewable energy sources.
In 2024, for instance, 91 percent of all newly commissioned utility-scale renewable projects delivered electricity at a lower cost than the cheapest new fossil fuel-fired alternative, according to findings of a study by the International Renewable Energy Agency (IRENA).
At the heart of its increased adoption will be strong economics, technological advancements, and a push for energy security and sovereignty, especially in Africa, where 600 million people live in the dark and cold. In many parts of the world, new renewable energy projects are already cheaper than fossil fuel alternatives....
Metadata:
  url: https://www.powershiftafrica.org/in-the-news/5-trends-to-watch-in-renewable-energy-in-2026
  title: 5 Trends to Watch in Renewable Energy in 2026 — Power Shift Africa
  description: 2026 is expected to be the year of accelerated growth in renewable energy adoption and investments globally, driven by falling costs, advancements in battery and storage technology, smart grids, increased finance, and favourable regulations in many countries around the world.
  page_age: 2026-01-16T12:49:35
  thumbnail_url: http://static1.squarespace.com/static/657880dcd408ac495a5cc888/t/695cf028a7d42717c250577d/1767698472558/unsplash-image-_qaHb5vTaic.jpg?format=1500w
  favicon_url: https://you.com/favicon?domain=www.powershiftafrica.org&size=128
  source_type: web

Result 13:
  Text: The announcement comes after Australia set a record for solar energy generation last year, becoming responsible for more than 12 per cent of the nation's power, and after more than 4.2 million households installed rooftop solar panels. The researchers, from UNSW's School of Photovoltaic and Renewable Energy Engineering, investigated ways to boost the efficiency of a material called antimony chalcogenide that has been tipped for use in future solar technology.
Further breakthroughs could be used in the university's spin-off company, Sydney Solar, which is developing transparent solar stickers that promise to generate energy from windows.
The material is abundant and inexpensive to use, is more stable than other candidates, and can be deployed in a layer much thinner than a human hair to improve energy efficiency....
Metadata:
  url: https://www.dailyadvertiser.com.au/story/9157416/stacking-solar-cells-could-deliver-cheaper-power/
  title: Stacking solar cells could deliver cheaper power
  description: A material touted as a candidate for next-generation solar technology is showing more promise, with Australian scientists behind...
  page_age: 2026-01-20T19:02:00
  thumbnail_url: https://www.dailyadvertiser.com.au/images/transform/v1/crop/frm/silverstone-feed-data/450eebf9-1c9e-4ba4-a74f-4e8cbbe500f9.jpg/r0_90_800_510_w1200_h630_fmax.jpg
  favicon_url: https://you.com/favicon?domain=www.dailyadvertiser.com.au&size=128
  source_type: web

Result 14:
  Text: While renewable electricity is widely recognized as key to achieving climate goals, its broader contribution to a sustainable and just energy transition remains underexplored. Several studies assess the effect of renewables on individual outcomes, but few adopt an integrated approach that captures the multiple dimensions of environmental sustainability, social well-being, and economic development.
Environment, Development and Sustainability - While renewable electricity is widely recognized as key to achieving climate goals, its broader contribution to a sustainable and just energy...
These results suggest that while renewable deployment may advance environmental and economic goals, its contribution to greater social equity is less evident, underscoring the importance of policies that explicitly integrate decarbonization with distributive justice and affordability. Future research should further explore the differentiated social impacts of renewable deployment across income groups, and household types, providing a stronger empirical basis for designing energy transitions that are not only sustainable but also just.
Limiting the global temperature increase to 1.5º C above pre-industrial levels, as outlined in the Paris Agreement (UNFCCC, 2015) requires a transition to climate-neural economy, driven by the rapid and deep decarbonization of the energy system, with renewable energy sources (RES) playing a pivotal role (IEA, 2022)....
Metadata:
  url: https://link.springer.com/article/10.1007/s10668-025-07221-0
  title: Are renewable energy sources advancing towards a sustainable society?
  description: While renewable electricity is widely recognized as key to achieving climate goals, its broader contribution to a sustainable and just energy transition remains underexplored. Several studies assess the effect of renewables on individual outcomes, but few adopt an integrated approach that captures ...
  page_age: 2026-01-21T00:00:00
  thumbnail_url: https://static-content.springer.com/image/art%3A10.1007%2Fs10668-025-07221-0/MediaObjects/10668_2025_7221_Fig1_HTML.png
  favicon_url: https://you.com/favicon?domain=link.springer.com&size=128
  source_type: web

Result 15:
  Text: The announcement comes after Australia set a record for solar energy generation last year, becoming responsible for more than 12 per cent of the nation's power, and after more than 4.2 million households installed rooftop solar panels. The researchers, from UNSW's School of Photovoltaic and Renewable Energy Engineering, investigated ways to boost the efficiency of a material called antimony chalcogenide that has been tipped for use in future solar technology.
Further breakthroughs could be used in the university's spin-off company, Sydney Solar, which is developing transparent solar stickers that promise to generate energy from windows.
The material is abundant and inexpensive to use, is more stable than other candidates, and can be deployed in a layer much thinner than a human hair to improve energy efficiency....
Metadata:
  url: https://www.bendigoadvertiser.com.au/story/9157416/stacking-solar-cells-could-deliver-cheaper-power/
  title: Stacking solar cells could deliver cheaper power
  description: A material touted as a candidate for next-generation solar technology is showing more promise, with Australian scientists behind...
  page_age: 2026-01-20T19:02:00
  thumbnail_url: https://www.bendigoadvertiser.com.au/images/transform/v1/crop/frm/silverstone-feed-data/450eebf9-1c9e-4ba4-a74f-4e8cbbe500f9.jpg/r0_90_800_510_w1200_h630_fmax.jpg
  favicon_url: https://you.com/favicon?domain=www.bendigoadvertiser.com.au&size=128
  source_type: web

Result 16:
  Text: The announcement comes after Australia set a record for solar energy generation last year, becoming responsible for more than 12 per cent of the nation's power, and after more than 4.2 million households installed rooftop solar panels. The researchers, from UNSW's School of Photovoltaic and Renewable Energy Engineering, investigated ways to boost the efficiency of a material called antimony chalcogenide that has been tipped for use in future solar technology.
Further breakthroughs could be used in the university's spin-off company, Sydney Solar, which is developing transparent solar stickers that promise to generate energy from windows.
The material is abundant and inexpensive to use, is more stable than other candidates, and can be deployed in a layer much thinner than a human hair to improve energy efficiency....
Metadata:
  url: https://www.dungogchronicle.com.au/story/9157416/stacking-solar-cells-could-deliver-cheaper-power/
  title: Stacking solar cells could deliver cheaper power | Dungog Chronicle ...
  description: A material touted as a candidate for next-generation solar technology is showing more promise, with Australian scientists behind...
  page_age: 2026-01-20T19:02:00
  thumbnail_url: https://www.dungogchronicle.com.au/images/transform/v1/crop/frm/silverstone-feed-data/450eebf9-1c9e-4ba4-a74f-4e8cbbe500f9.jpg/r0_90_800_510_w1200_h630_fmax.jpg
  favicon_url: https://you.com/favicon?domain=www.dungogchronicle.com.au&size=128
  source_type: web

Result 17:
  Text: The announcement comes after Australia set a record for solar energy generation last year, becoming responsible for more than 12 per cent of the nation's power, and after more than 4.2 million households installed rooftop solar panels. The researchers, from UNSW's School of Photovoltaic and Renewable Energy Engineering, investigated ways to boost the efficiency of a material called antimony chalcogenide that has been tipped for use in future solar technology.
Further breakthroughs could be used in the university's spin-off company, Sydney Solar, which is developing transparent solar stickers that promise to generate energy from windows.
The material is abundant and inexpensive to use, is more stable than other candidates, and can be deployed in a layer much thinner than a human hair to improve energy efficiency....
Metadata:
  url: https://www.newcastleherald.com.au/story/9157416/stacking-solar-cells-could-deliver-cheaper-power/
  title: Stacking solar cells could deliver cheaper power | Newcastle Herald ...
  description: A material touted as a candidate for next-generation solar technology is showing more promise, with Australian scientists behind...
  page_age: 2026-01-20T19:02:00
  thumbnail_url: https://www.newcastleherald.com.au/images/transform/v1/crop/frm/silverstone-feed-data/450eebf9-1c9e-4ba4-a74f-4e8cbbe500f9.jpg/r0_90_800_510_w1200_h630_fmax.jpg
  favicon_url: https://you.com/favicon?domain=www.newcastleherald.com.au&size=128
  source_type: web

Result 18:
  Text: The announcement comes after Australia set a record for solar energy generation last year, becoming responsible for more than 12 per cent of the nation's power, and after more than 4.2 million households installed rooftop solar panels. The researchers, from UNSW's School of Photovoltaic and Renewable Energy Engineering, investigated ways to boost the efficiency of a material called antimony chalcogenide that has been tipped for use in future solar technology.
Further breakthroughs could be used in the university's spin-off company, Sydney Solar, which is developing transparent solar stickers that promise to generate energy from windows.
The material is abundant and inexpensive to use, is more stable than other candidates, and can be deployed in a layer much thinner than a human hair to improve energy efficiency....
Metadata:
  url: https://www.mandurahmail.com.au/story/9157416/stacking-solar-cells-could-deliver-cheaper-power/
  title: Stacking solar cells could deliver cheaper power | Mandurah Mail ...
  description: A material touted as a candidate for next-generation solar technology is showing more promise, with Australian scientists behind...
  page_age: 2026-01-20T19:02:00
  thumbnail_url: https://www.mandurahmail.com.au/images/transform/v1/crop/frm/silverstone-feed-data/450eebf9-1c9e-4ba4-a74f-4e8cbbe500f9.jpg/r0_90_800_510_w1200_h630_fmax.jpg
  favicon_url: https://you.com/favicon?domain=www.mandurahmail.com.au&size=128
  source_type: web

Result 19:
  Text: The announcement comes after Australia set a record for solar energy generation last year, becoming responsible for more than 12 per cent of the nation's power, and after more than 4.2 million households installed rooftop solar panels. The researchers, from UNSW's School of Photovoltaic and Renewable Energy Engineering, investigated ways to boost the efficiency of a material called antimony chalcogenide that has been tipped for use in future solar technology.
Further breakthroughs could be used in the university's spin-off company, Sydney Solar, which is developing transparent solar stickers that promise to generate energy from windows.
The material is abundant and inexpensive to use, is more stable than other candidates, and can be deployed in a layer much thinner than a human hair to improve energy efficiency....
Metadata:
  url: https://www.yasstribune.com.au/story/9157416/stacking-solar-cells-could-deliver-cheaper-power/
  title: Stacking solar cells could deliver cheaper power | Yass Tribune ...
  description: A material touted as a candidate for next-generation solar technology is showing more promise, with Australian scientists behind...
  page_age: 2026-01-20T19:02:00
  thumbnail_url: https://www.yasstribune.com.au/images/transform/v1/crop/frm/silverstone-feed-data/450eebf9-1c9e-4ba4-a74f-4e8cbbe500f9.jpg/r0_90_800_510_w1200_h630_fmax.jpg
  favicon_url: https://you.com/favicon?domain=www.yasstribune.com.au&size=128
  source_type: web

Result 20:
  Text: The announcement comes after Australia set a record for solar energy generation last year, becoming responsible for more than 12 per cent of the nation's power, and after more than 4.2 million households installed rooftop solar panels. The researchers, from UNSW's School of Photovoltaic and Renewable Energy Engineering, investigated ways to boost the efficiency of a material called antimony chalcogenide that has been tipped for use in future solar technology.
Further breakthroughs could be used in the university's spin-off company, Sydney Solar, which is developing transparent solar stickers that promise to generate energy from windows.
The material is abundant and inexpensive to use, is more stable than other candidates, and can be deployed in a layer much thinner than a human hair to improve energy efficiency....
Metadata:
  url: https://www.standard.net.au/story/9157416/stacking-solar-cells-could-deliver-cheaper-power/
  title: Stacking solar cells could deliver cheaper power | The Standard ...
  description: A material touted as a candidate for next-generation solar technology is showing more promise, with Australian scientists behind...
  page_age: 2026-01-20T19:02:00
  thumbnail_url: https://www.standard.net.au/images/transform/v1/crop/frm/silverstone-feed-data/450eebf9-1c9e-4ba4-a74f-4e8cbbe500f9.jpg/r0_90_800_510_w1200_h630_fmax.jpg
  favicon_url: https://you.com/favicon?domain=www.standard.net.au&size=128
  source_type: web

Using with Query Engine

Now that we’ve seen how to customize the web data we want to retrieve, let’s use an LLM to synthesize natural language answers from the search results. In this example, we’ll use a model from Anthropic.

%pip install llama-index-llms-anthropic

import os
from getpass import getpass

# Set your Anthropic API key
anthropic_api_key = os.environ.get("ANTHROPIC_API_KEY") or getpass(
    "Enter your Anthropic API key: "
)

from llama_index.core.query_engine import RetrieverQueryEngine
from llama_index.llms.anthropic import Anthropic
from llama_index.core import Settings
from llama_index.retrievers.you import YouRetriever

# Configure Anthropic as your LLM
llm = Anthropic(model="claude-haiku-4-5-20251001", api_key=anthropic_api_key)

# Create a query engine that uses You.com search results as context
retriever = YouRetriever(api_key=you_api_key)
query_engine = RetrieverQueryEngine.from_args(retriever, llm)

# The query engine:
# 1. Uses the retriever to fetch relevant search results from You.com
# 2. Passes those results as context to the LLM
# 3. Returns a synthesized answer

response = query_engine.query(
    "What are the most visited national parks in the US and why? keep it brief."
)

# Try a different query
# response = query_engine.query("What are the latest geopolitical updates from India")

print(str(response))

# Most Visited National Parks in the US

**Top 3 Most Visited:**

1. **Great Smoky Mountains National Park** (North Carolina/Tennessee) - 13.3 million visitors
   - Why: Gorgeous ancient mountains, diverse plant and animal life, historical Southern Appalachian culture, and home to American black bears and other wildlife

2. **Zion National Park** (Utah) - 4.9 million visitors
   - Why: Striking vertical topography with red rock formations, sandstone canyons, and sharp cliffs

3. **Grand Canyon National Park** (Arizona) - 4.7 million visitors
   - Why: Iconic mile-deep canyon with spectacular erosion examples and incomparable vistas from both rims

**Other Popular Parks:**
- **Yosemite National Park** (California) - Famous for towering granite cliffs, waterfalls, and giant sequoias
- **Glacier National Park** (Montana) - Mountain landscapes shaped by glacial forces

These parks attract millions of visitors annually due to their dramatic natural landscapes, diverse ecosystems, abundant wildlife, and extensive outdoor recreation opportunities like hiking, boating, and wildlife viewing.

Why this format?

The retriever converts You.com’s JSON response into LlamaIndex’s standard NodeWithScore format. This provides:

Benefits:

Source-agnostic: Same interface whether retrieving from You.com, vector DBs, or other sources
Composability: Easily combine multiple retrievers or swap them out
Integration: Works seamlessly with LlamaIndex query engines, agents, and other components

What’s preserved:

Text content: Snippets from web results or descriptions from news articles
Metadata: URL, title, page_age stored in the metadata dict
Score: Relevance score (1.0 by default since You.com doesn’t provide scores)

This abstraction lets you focus on building applications rather than handling API-specific response formats.