Learn how to make your first API request.

Welcome to Linkup!

The Linkup API is designed for AIs to find and access high quality content on the internet.

To quickly get started using our SDKs or directly with cURL, follow these steps:

🔑 1. Get your API key

Create an account and grab your API key here.

📦 2. Install the SDK

pip install linkup-sdk
// Coming soon :)

🤖 3. Call the API

You can, for instance:

Get a sourced answer to your question

from linkup import LinkupClient
from pprint import pp

client = LinkupClient(api_key="<YOUR_LINKUP_API_KEY>")

response = client.search(
    query="Can you tell me which women were awared the Physics Nobel Prize",
    depth="standard",
    output_type="sourcedAnswer"
)

pp(response)
// Coming soon :)
curl "https://api.linkup.so/v1/search" \
    -G \
    -H "Authorization: Bearer $LINKUP_API_KEY" \
    --data-urlencode "q=Can you tell me which women were awared the Physics Nobel Prize" \
    --data-urlencode "depth=standard" \
    --data-urlencode "ouputType=sourcedAnswer"

Response:

LinkupSourcedAnswer(
    answer="The five women who have won the Nobel Prize in Physics are:\n1. Marie Curie (1903)\n2. Maria Goeppert Mayer (1963)\n3. Donna Strickland (2018)\n4. Andrea Ghez (2020)\n5. Anne L'Huillier (2023)",
    sources=[
        LinkupSource(
            name="Women in physics - Wikipedia",
            url="https://en.wikipedia.org/wiki/Women_in_physics",
            snippet="Learn about the five women who have won the Nobel Prize in Physics, including Marie Curie, the first woman to receive the prize in 1903.",
        ),
        LinkupSource(
            name="Only 5 women have won the Nobel Prize in physics—recent winners share ...",
            url="https://phys.org/news/2024-10-women-won-nobel-prize-physics.html",
            snippet="Out of 225 people awarded the Nobel Prize in physics, only five have been women.",
        ),
        LinkupSource(
            name="List of female Nobel laureates - Wikipedia",
            url="https://en.wikipedia.org/wiki/List_of_female_Nobel_laureates",
            snippet="The first woman to win a Nobel Prize was Marie Curie in Physics in 1903, and the most recent ones were Anne L'Huillier in Physics and Katalin Karikó in Physiology or Medicine in 2023.",
        ),
    ],
)
// Coming soon :)
{
    "answer": "The women awarded the Nobel Prize in Physics are Marie Curie (1903), Maria Goeppert Mayer (1963), Donna Strickland (2018), Andrea Ghez (2020), and Anne L'Huillier (2023).",
    "sources": [
        {
            "name": "Only 5 women have won the Nobel Prize in physics—recent winners share ...",
            "url": "https://phys.org/news/2024-10-women-won-nobel-prize-physics.html",
            "snippet": "The three woman physicists receiving Nobel Prize honors in the 21st century are Donna Strickland, who won in 2018, Andrea Ghez, who won in 2020, and Anne L'Huillier, who won in 2023."
        },
        {
            "name": "The Women Who Win - Physics",
            "url": "https://physics.aps.org/articles/v14/134",
            "snippet": "As of today, there are four women Nobel physics laureates, including Donna Strickland, who received the prize in 2018, and Ghez, who received it last ..."
        },
        {
            "name": "Nobel Prize awarded women - NobelPrize.org",
            "url": "https://www.nobelprize.org/prizes/lists/nobel-prize-awarded-women/",
            "snippet": "Only one woman, Marie Curie, has been honoured twice, with the Nobel Prize in Physics 1903 and the Nobel Prize in Chemistry 1911."
        },
        {
            "name": "Four women who changed the face of physics - BBC",
            "url": "https://www.bbc.com/news/science-environment-45730921",
            "snippet": "Donna Strickland has become only the third woman in history to win the Nobel prize for Physics. She joins Marie Curie, who won in 1903, and Maria ..."
        }
    ]
}

Get relevant documents - which could be useful to build a RAG :)

from linkup import LinkupClient
from pprint import pp

client = LinkupClient(api_key="<YOUR_LINKUP_API_KEY>")

response = client.search(
    query="Can you tell me which women were awared the Physics Nobel Prize",
    depth="standard",
    output_type="searchResults"
)

pp(response)
// Coming soon :)
curl "https://api.linkup.so/v1/search" \
    -G \
    -H "Authorization: Bearer $LINKUP_API_KEY" \
    --data-urlencode "q=Can you tell me which women were awared the Physics Nobel Prize" \
    --data-urlencode "depth=standard" \
    --data-urlencode "outputType=searchResults"

Response:

LinkupSearchResults(
    results=[
        LinkupSearchResult(
            name="Women in physics - Wikipedia",
            url="https://en.wikipedia.org/wiki/Women_in_physics",
            content='Several women have been selected as Clarivate Citation laureates in Physics, which makes an annual list of possible candidates for the Nobel Prize in Physics based on citation statistics, these include: . 2008 Vera Rubin † "for her pioneering research indicating the existence of dark matter in the universe." [26]2012 Lene Hau "for the experimental demonstration of electromagnetically induced ...',
        ),      
        LinkupSearchResult(
            name="The Nobel Prize In Physics: 117 Years, 3 Women And Counting",
            url="https://www.npr.org/2018/10/02/653639583/the-nobel-prize-in-physics-117-years-three-women-and-counting",
            content="In 1974, They Gave The Nobel To Her Supervisor. Now She's Won A $3 Million Prize. But there haven't been. Only the famous scientist Marie Curie and Maria Goeppert Mayer, a nuclear physicist, have ...",
        ),
        LinkupSearchResult(
            name="Four women who changed the face of physics - BBC News",
            url="https://www.bbc.co.uk/news/science-environment-45730921",
            content="Donna Strickland has become only the third woman in history to win the Nobel prize for Physics. She joins Marie Curie, who won in 1903, and Maria Goeppert-Mayer, who was awarded the prize in 1963.",
        ),
        LinkupSearchResult(
            name="Only 5 women have won the Nobel Prize in physics—recent winners share ...",
            url="https://phys.org/news/2024-10-women-won-nobel-prize-physics.pdf",
            content="The three woman physicists receiving Nobel Prize honors in the 21st century are Donna Strickland, who won in 2018, Andrea Ghez, who won in 2020, and Anne L'Huillier, who won in 2023.",
        ),
        ...
    ]
)
// Coming soon :)
{
    "results": [
        {
            "name": "Women in physics - Wikipedia",
            "url": "https://en.wikipedia.org/wiki/Women_in_physics",
            "content": "Irène Joliot-Curie [10] and Dorothy Hodgkin [11] were also nominated for the Nobel Prize in Physics, but received a Nobel Prize in Chemistry in 1935 and 1964, respectively. Lise Meitner is the female physicist the most nominated, 16 times for Physics and 14 times for Chemistry. [20] About 1.7% of the Nobel nominations in Physics up to 1970 ..."
        },
        {
            "name": "The Nobel Prize In Physics: 117 Years, 3 Women And Counting",
            "url": "https://www.npr.org/2018/10/02/653639583/the-nobel-prize-in-physics-117-years-three-women-and-counting",
            "content": "In 1974, They Gave The Nobel To Her Supervisor. Now She's Won A $3 Million Prize. But there haven't been. Only the famous scientist Marie Curie and Maria Goeppert Mayer, a nuclear physicist, have ..."
        },
        {
            "name": "Nobel Prize awarded women - NobelPrize.org",
            "url": "https://www.nobelprize.org/prizes/lists/nobel-prize-awarded-women/",
            "content": "Nobel Prize awarded women The Nobel Prize and the Sveriges Riksbank Prize in Economic Sciences in Memory of Alfred Nobel have been awarded to women 66 times between 1901 and 2024. Only one woman, Marie Curie, has been honoured twice, with the Nobel Prize in Physics 1903 and the Nobel Prize in Chemistry 1911."
        },
        {
            "name": "Nobel Prize awarded women - NobelPrize.org",
            "url": "https://www.nobelprize.org/prizes/lists/nobel-prize-awarded-women/?gallery_style=page",
            "content": "The Nobel Prize and the Sveriges Riksbank Prize in Economic Sciences in Memory of Alfred Nobel have been awarded to women 66 times between 1901 and 2024. Only one woman, Marie Curie, has been honoured twice, with the Nobel Prize in Physics 1903 and the Nobel Prize in Chemistry 1911."
        },
        {
            "name": "You can count female physics Nobel laureates on one hand – recent ...",
            "url": "https://theconversation.com/you-can-count-female-physics-nobel-laureates-on-one-hand-recent-winners-have-wisdom-for-young-women-in-the-field-239030",
            "content": "Out of 225 people awarded the Nobel Prize in physics, only five have been women. This is a very small number, and certainly smaller than 50% – the percent of women in the human population."
        },
        {
            "name": "The 60 Women Who Have Won the Nobel Prize - Stacker",
            "url": "https://stacker.com/history/60-women-who-have-won-nobel-prize",
            "content": "- Award: Nobel Prize in Physics - Year: 1963. Maria Goeppert-Mayer was born in Germany. After she married, she migrated to America, where she worked on an American atom bomb project during World War II. Her work uncovered important discoveries about nuclear structure, and Goeppert-Mayer is one of only four women to win the Nobel Prize in physics."
        },
        {
            "name": "The Women Who Win - Physics",
            "url": "https://physics.aps.org/articles/v14/134",
            "content": "As of today, there are four women Nobel physics laureates, including Donna Strickland, who received the prize in 2018, and Ghez, who received it last year (there are 215 Nobel physics laureates in total). Women physicists are also increasingly receiving other major prizes, which is “heartening, but only a first step,” says Samaya Nissanke ..."
        },
        {
            "name": "Only 5 women have won the Nobel Prize in physics—recent winners share ...",
            "url": "https://phys.org/news/2024-10-women-won-nobel-prize-physics.html",
            "content": "Out of 225 people awarded the Nobel Prize in physics, only five have been women. This is a very small number, and certainly smaller than 50%—the percent of women in the human population."
        },
        {
            "name": "These Are the 57 Women Who Have Won the Nobel Prize",
            "url": "https://www.newsweek.com/these-are-57-women-who-have-won-nobel-prize-1538702",
            "content": "Getty Images/Hulton-Deutsch Collection/CORBIS Marie Curie (born Skłodowska) - Award: Nobel Prize in Physics - Year: 1903. Marie Curie, who was the first woman to win a Nobel Prize, coined the ..."
        },
        {
            "name": "The Nobel Prize | Women who changed science | Donna Strickland",
            "url": "https://www.nobelprize.org/womenwhochangedscience/stories/donna-strickland",
            "content": "With enthusiasm for the field and “very, very hard” work, she found a way to create high-intensity laser pulses. This technique, chirped pulse amplification or CPA, was described in Strickland’s very first scientific paper, and it led to her 2018 Nobel Prize in Physics."
        }
    ]
}

Get a structured response to your question

from linkup import LinkupClient
from pprint import pp
from pydantic import BaseModel
from typing import List

client = LinkupClient(api_key="<YOUR_LINKUP_API_KEY>")

class NobelPrize(BaseModel):
    first_name: str
    last_name: str
    year: int

class NobelPrizes(BaseModel):
    response: List[NobelPrize]

response = client.search(
    query="Can you tell me which women were awared the Physics Nobel Prize",
    depth="standard",
    output_type="structured",
    structured_output_schema=NobelPrizes,
)

pp(response)
// Coming soon :)
curl "https://api.linkup.so/v1/search" \
    -G \
    -H "Authorization: Bearer $LINKUP_API_KEY" \
    --data-urlencode "q=Can you tell me which women were awared the Physics Nobel Prize" \
    --data-urlencode "depth=standard"
    --data-urlencode "outputType=structured" \
    --data-urlencode 'structuredOutputSchema={ "type": "object", "properties": { "response": { "type": "array", "items": { "type": "object", "properties": { "fistName": { "type": "string" }, "lastName": { "type": "string" }, "year": { "type": "number" } } } } } }'

Response:

NobelPrizes(
    response=[
        NobelPrize(first_name="Marie", last_name="Curie", year=1903),
        NobelPrize(first_name="Maria", last_name="Goeppert Mayer", year=1963),
        NobelPrize(first_name="Donna", last_name="Strickland", year=2018),
        NobelPrize(first_name="Andrea", last_name="Ghez", year=2020),
        NobelPrize(first_name="Gerrit", last_name="Klaste", year=2022),
    ]
)
// Coming soon :)
{
    "response": [
        {
            "fistName": "Marie",
            "lastName": "Curie",
            "year": 1903
        },
        {
            "fistName": "Maria",
            "lastName": "Goeppert-Mayer",
            "year": 1963
        },
        {
            "fistName": "Donna",
            "lastName": "Strickland",
            "year": 2018
        },
        {
            "fistName": "Andrea",
            "lastName": "Ghez",
            "year": 2020
        },
        {
            "fistName": "Anne",
            "lastName": "L'Huillier",
            "year": 2023
        }
    ]
}