​
Create and setup your API key

  1. Go to the Exa Dashboard
  2. Click on “API Keys” in the left sidebar
  3. Click “Create API Key”
  4. Give your key a name and click “Create”
  5. Copy your API key and store it securely - you won’t be able to see it again!

Get your Exa API key

​
Create a .env file

Create a file called .env in the root of your project and add the following line. 
EXA_API_KEY=your api key without quotes

​
Make an API request

Use our Python or JavaScript SDKs, or call the API directly with cURL.
Install the latest version of the python SDK with pip. If you want to store your API key in a .env file, make sure to install the dotenv library.
pip install exa-py
pip install python-dotenv
Create a file called webset.py and add the code below:
python
from exa_py import Exa
from dotenv import load_dotenv
from exa_py.websets.types import CreateWebsetParameters, CreateEnrichmentParameters

import os

load_dotenv()
exa = Exa(os.getenv('EXA_API_KEY'))

# Create a Webset with search and enrichments
webset = exa.websets.create(
    params=CreateWebsetParameters(
        search={
            "query": "Top AI research labs focusing on large language models",
            "count": 5
        },
        enrichments=[
            CreateEnrichmentParameters(
                description="LinkedIn profile of VP of Engineering or related role",
                format="text",
            ),
        ],
    )
)

print(f"Webset created with ID: {webset.id}")

# Wait until Webset completes processing
webset = exa.websets.wait_until_idle(webset.id)

# Retrieve Webset Items
items = exa.websets.items.list(webset_id=webset.id)
for item in items.data:
    print(f"Item: {item.model_dump_json(indent=2)}")

​
What’s next?

  • Learn how Websets work and understand the event-driven process
  • Configure Monitors to automatically receive continuous updates for your Websets
  • Configure webhooks to receive real-time updates as items are added into your Websets
  • Learn about Enrichments to extract specific data points
  • See how to Manage Items in your Webset