Skip to main content

​
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.
  • Python
  • JavaScript
  • 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
⌘I