Initial Setup
More Examples
Quickstart
Introduction
Welcome to the Quickstart Guide for integrating comprehensive, high-quality answers with precise and reliable citations using our Smart, Research, Search and News APIs. This guide will walk you through the initial setup and provide you with sample code to perform searches and retrieve results.
Step 1: Set Up Your API Key
Before You Get Started
To use the You.com Smart, Research, Search and News LLM endpoints, you can get an API key through the self-serve portal at api.you.com. For support, please reach out via email at api@you.com.
Replace X-API-Key
in the code with your actual API key:
YOUR_API_KEY = "your_actual_api_key_here"
Step 2: Write the Search Function
Create a function to interact with the Research API:
import requests
def get_smart_results(query):
headers = {"X-API-Key": YOUR_API_KEY}
params = {"query": query, "instructions": instructions}
return requests.get(
"https://chat-api.you.com/smart?query={query}",
params=params,
headers=headers,
).json()
Use the function to search for AI snippets related to a specific topic:
get_smart_results("Who won the Nobel Prize in Physics in 2024?")
{
"answer":"#### The 2024 Nobel Prize in Physics\n\n
The 2024 Nobel Prize in Physics was awarded jointly to **John J. Hopfield**
and **Geoffrey E. Hinton** \"for foundational discoveries and inventions that
enable machine learning with artificial neural networks\".
[[1]](https://www.nobelprize.org/prizes/physics/2024/summary/) [[2]](https://www.nobelprize.org/prizes/physics/2024/press-release/)\n\n
Hopfield and Hinton are pioneers in the field of artificial intelligence and
machine learning. Their work in the 1980s laid the groundwork for the development of
modern neural networks and deep learning algorithms, which are now widely used in
various applications.
[[3]](https://www.nobelprize.org/prizes/physics/2024/popular-information/) [[4]](https://spectrum.ieee.org/nobel-prize-in-physics)\n\n
Specifically, Hopfield created a structure that can store and reconstruct information, while Hinton
invented a method that can autonomously find properties in data, which are key
innovations that make artificial intelligence work.
[[5]](https://www.weforum.org/stories/2024/10/nobel-prize-winners-2024/)\n\n
The Nobel Prize committee recognized their \"foundational discoveries
and inventions that enable machine learning with artificial neural networks\",
highlighting how their work has been instrumental in the rapid progress of AI and machine
learning in recent years.
[[1]](https://www.nobelprize.org/prizes/physics/2024/summary/) [[2]](https://www.nobelprize.org/prizes/physics/2024/press-release/)"
"search_results":[
{
"url":"https://www.nobelprize.org/prizes/physics/2024/summary/",
"name":"The Nobel Prize in Physics 2024 - NobelPrize.org",
"snippet":"The Nobel Prize in Physics 2024 was awarded jointly to John J. Hopfield and Geoffrey E. Hinton \"for foundational discoveries and inventions that enable machine learning with artificial neural networks\"",
"metadata":"None"
},
{
"url":"https://www.nobelprize.org/prizes/physics/2024/press-release/",
"name":"Press release: The Nobel Prize in Physics 2024 - NobelPrize.org",
"snippet":"The Nobel Prize in Physics 2024 was awarded jointly to John J. Hopfield and Geoffrey E. Hinton \"for foundational discoveries and inventions that enable machine learning with artificial neural networks\"",
"metadata":"None"
},
{
"url":"https://www.nobelprize.org/prizes/physics/",
"name":"Nobel Prize in Physics",
"snippet":"The Nobel Prize medal. ... A slide rule that physics laureate Toshihide Maskawa used as a high school student.",
"metadata":"None"
},
{
"url":"https://www.nobelprize.org/all-nobel-prizes-2024/",
"name":"All Nobel Prizes 2024 - NobelPrize.org",
"snippet":"Ill. Niklas Elmehed © Nobel Prize Outreach · This year’s laureates used tools from physics to construct methods that helped lay the foundation for today’s powerful machine learning. John Hopfield created a structure that can store and reconstruct information.",
"metadata":"None"
},
{
"url":"https://www.aps.org/about/news/2024/10/nobel-physics-2024-winners",
"name":"APS congratulates 2024 Nobel Prize winners",
"snippet":"The latest news and announcements about APS and the global physics community.",
"metadata":"None"
},
{
"url":"https://www.nobelprize.org/prizes/physics/2024/popular-information/",
"name":"The Nobel Prize in Physics 2024 - Popular science background - NobelPrize.org",
"snippet":"The Nobel Prize in Physics 2024 was awarded jointly to John J. Hopfield and Geoffrey E. Hinton \"for foundational discoveries and inventions that enable machine learning with artificial neural networks\"",
"metadata":"None"
},
{
"url":"https://time.com/7065011/nobel-prize-2024-winners/",
"name":"These Are the Winners of the 2024 Nobel Prizes",
"snippet":"Victor Ambros and Gary Ruvkun were on Monday awarded the 2024 Nobel Prize in Physiology or Medicine for their discovery of microRNAs, a class of small molecules essential for gene regulation. Their research has uncovered how these microRNAs influence cellular behavior and contribute to various ...",
"metadata":"None"
},
{
"url":"https://www.reuters.com/science/hopfield-hinton-win-2024-nobel-prize-physics-2024-10-08/",
"name":"Nobel physics prize 2024 won by AI pioneers John Hopfield and Geoffrey Hinton | Reuters",
"snippet":"[1/6]John J Hopfield and Geoffrey E Hinton are awarded this year's Nobel Prize in Physics, announced at a press conference at the Royal Swedish Academy of Sciences in Stockholm, Sweden October 8, 2024.",
"metadata":"None"
},
{
"url":"https://www.weforum.org/stories/2024/10/nobel-prize-winners-2024/",
"name":"These are the Nobel Prize winners of 2024 | World Economic Forum",
"snippet":"AI pioneers John Hopfield and Geoffrey Hinton were both awarded the Physics prize, for using tools to develop methods that are the foundation of today’s machine learning. Widely credited as \"a godfather of AI\", British-Canadian Hinton invented a method that can autonomously find properties ...",
"metadata":"None"
},
{
"url":"https://new.nsf.gov/news/nsf-congratulates-laureates-2024-nobel-prize-physics",
"name":"NSF congratulates laureates of the 2024 Nobel Prize in physics | NSF - National Science Foundation",
"snippet":"Two researchers used fundamental knowledge of the physical properties of materials to create key innovations that make artificial intelligence work ... The U.S. National Science Foundation congratulates John J. Hopfield and Geoffrey E. Hinton for their Nobel Prize in physics.",
"metadata":"None"
},
{
"url":"https://www.nobelprize.org/prizes/lists/all-nobel-prizes-in-physics/",
"name":"All Nobel Prizes in Physics - NobelPrize.org",
"snippet":"The Nobel Prize in Physics has been awarded 118 times to 227 Nobel Prize laureates between 1901 and 2024. John Bardeen is the only laureate who has been awarded the Nobel Prize in Physics twice, in 1956 and 1972. This means that a total of 226 individuals have received the Nobel Prize in Physics.",
"metadata":"None"
},
{
"url":"https://en.wikipedia.org/wiki/List_of_Nobel_laureates_in_Physics",
"name":"List of Nobel laureates in Physics - Wikipedia",
"snippet":"The Nobel Prize in Physics has ... as of 2024. The first prize in physics was awarded in 1901 to Wilhelm Conrad Röntgen, of Germany, who received 150,782 SEK. John Bardeen is the only laureate to win the prize twice—in 1956 and 1972. William Lawrence Bragg was the youngest Nobel laureate in physics; he won the prize ...",
"metadata":"None"
},
{
"url":"https://www.reddit.com/r/math/comments/1fyzz6t/the_nobel_prize_in_physics_2024_was_awarded_to/",
"name":"r/math on Reddit: The Nobel Prize in Physics 2024 was awarded to John J. Hopfield and Geoffrey E. Hinton \"for foundational discoveries and inventions that enable machine learning with artificial neural networks\"",
"snippet":"I think the Boltzmann machine is a really beautiful model, even from the mathematical point of view. I’m still a little bit shocked when I learned that the Nobel Prize in Physics 2024 goes to ML/DL, as much as I also like (theoretical) computer science.",
"metadata":"None"
},
{
"url":"https://spectrum.ieee.org/nobel-prize-in-physics",
"name":"Why the Nobel Prize in Physics Went to AI Research",
"snippet":"The Nobel Prize Committee for Physics caught the academic community off-guard by handing the 2024 award to John J. Hopfield and Geoffrey E. Hinton for their foundational work in neural networks. The pair won the prize for their seminal papers, both published in the 1980s, that described rudimentary ...",
"metadata":"None"
},
{
"url":"https://www.nytimes.com/2024/10/08/science/nobel-prize-physics.html",
"name":"Nobel Physics Prize Awarded for Pioneering A.I. Research by 2 Scientists - The New York Times",
"snippet":"With work on machine learning that uses artificial neural networks, John J. Hopfield and Geoffrey E. Hinton “showed a completely new way for us to use computers,” the committee said.",
"metadata":"None"
},
{
"url":"https://www.reuters.com/world/nobel-prize-2024-live-physics-award-be-announced-2024-10-08/",
"name":"Nobel Physics Prize 2024: Winners are machine learning pioneers Hopfield and Hinton - as it happened | Reuters",
"snippet":"The award-giving body said the pair used tools from physics to develop methods \"that are the foundation of today\\'s powerful machine learning.\"",
"metadata":"None"
},
{
"url":"https://finshots.in/archive/whats-up-with-ai-and-the-2024-physics-nobel-prize/",
"name":"What's up with AI and the 2024 Physics Nobel Prize?",
"snippet":"An explainer of why two pioneers of AI, John Hopfield and Geoffrey Hinton, were awarded the 2024 Nobel Prize in Physics.",
"metadata":"None"
},
{
"url":"https://www.pbs.org/newshour/science/watch-live-the-winner-of-the-2024-nobel-prize-in-physics-is",
"name":"WATCH: AI pioneers John Hopfield and Geoffrey Hinton win 2024 Nobel Prize in physics | PBS News",
"snippet":"Hinton, who is known as the Godfather of artificial intelligence, is a citizen of Canada and Britain who works at the University of Toronto and Hopfield is an American working at Princeton.",
"metadata":"None"
},
{
"url":"https://en.wikipedia.org/wiki/Nobel_Prize_in_Physics",
"name":"Nobel Prize in Physics - Wikipedia",
"snippet":"The first Nobel Prize in Physics was awarded to German physicist Wilhelm Röntgen in recognition of the extraordinary services he rendered by the discovery of X-rays. This award is administered by the Nobel Foundation and is widely regarded as the most prestigious award that a scientist can receive in physics. It is presented in Stockholm at an annual ceremony on the 10th of December, the anniversary of Nobel's death. As of 2024...",
"metadata":"None"
},
{
"url":"https://www.jagranjosh.com/general-knowledge/list-of-2024-nobel-prize-winners-in-all-categories-1728376617-1",
"name":"Nobel Prize 2024 Winners List: Recipient Name, Achievement from All Categories",
"snippet":"Discover the complete list of Nobel Prize 2024 winners. Stay updated on the latest achievements and contributions recognized by the Nobel Committee this year.",
"metadata":"None"
},
{
"url":"https://www.artsci.utoronto.ca/news/geoffrey-hinton-wins-2024-nobel-prize-physics",
"name":"Geoffrey Hinton wins 2024 Nobel Prize in Physics | Faculty of Arts & Science",
"snippet":"Geoffrey Hinton, a University Professor Emeritus of the Department of Computer Science at the University of Toronto, has been awarded the 2024 Nobel Prize in Physics.",
"metadata":"None"
},
{
"url":"https://www.ap.org/news-highlights/spotlights/2024/pioneers-in-artificial-intelligence-win-the-nobel-prize-in-physics/",
"name":"Pioneers in artificial intelligence win the Nobel Prize in physics | The Associated Press",
"snippet":"This photo combo shows the 2024 Nobel Prize winners in Physics, professor John Hopfield, left, of Princeton University, and professor Geoffrey Hinton, of the University of Toronto, Tuesday, Oct. 8, 2024. (Princeton University via AP and Noah Berger/AP Photo) STOCKHOLM (AP) — Two pioneers of artificial intelligence — John Hopfield and Geoffrey Hinton — won ...",
"metadata":"None"
},
{
"url":"https://twitter.com/NobelPrize",
"name":"The Nobel Prize (@NobelPrize) · X",
"snippet":"The latest tweets from The Nobel Prize (@NobelPrize)",
"metadata":"None"
},
{
"url":"https://www.aljazeera.com/news/2024/10/8/john-hopfield-and-geoffrey-hinton-win-nobel-prize-in-physics-2024",
"name":"AI scientists John Hopfield, Geoffrey Hinton win 2024 physics Nobel Prize | Science and Technology News | Al Jazeera",
"snippet":"John Hopfield and Geoffrey Hinton have won the Nobel Prize in physics 2024 for their pioneering work in the field of machine learning.",
"metadata":"None"
}
]
}
Explore our APIs
Unlock new possibilities with our suite of advanced APIs tailored to meet your needs and explore more use cases.