Exa Python SDK
The official Python SDK for Exa, the web search API for AI.
Install
pip install exa-py
Requires Python 3.9+
Quick Start
from exa_py import Exa
exa = Exa(api_key="your-api-key")
# Search the web
results = exa.search(
"blog post about artificial intelligence",
type="auto",
contents={"highlights": True}
)
# Ask a question
response = exa.answer("What is the capital of France?")
Search
results = exa.search(
"machine learning startups",
contents={"highlights": True}
)
results = exa.search(
"climate tech news",
num_results=20,
start_published_date="2024-01-01",
include_domains=["techcrunch.com", "wired.com"],
contents={"highlights": True}
)
results = exa.search(
"What are the latest battery breakthroughs?",
type="auto",
system_prompt="Prefer official sources and avoid duplicate results",
output_schema={
"type": "object",
"properties": {
"summary": {"type": "string"},
"key_companies": {"type": "array", "items": {"type": "string"}},
},
"required": ["summary", "key_companies"],
},
)
print(results.output.content if results.output else None)
for chunk in exa.stream_search(
"What are the latest battery breakthroughs?",
type="auto",
):
if chunk.content:
print(chunk.content, end="", flush=True)
Search output_schema modes:
{"type": "text", "description": "..."}: return plain text inoutput.content{"type": "object", ...}: return structured JSON inoutput.content
system_prompt and output_schema are supported on every search type.
Search streaming is available via stream_search(...), which yields OpenAI-style chat completion chunks.
For type: "object", search currently enforces:
- max nesting depth:
2 - max total properties:
10
Deep search variants that also support additional_queries:
deep-litedeepdeep-reasoning
Contents
results = exa.get_contents(
["https://docs.exa.ai"],
text=True
)
results = exa.get_contents(
["https://arxiv.org/abs/2303.08774"],
highlights=True
)
Answer
response = exa.answer("What caused the 2008 financial crisis?")
print(response.answer)
for chunk in exa.stream_answer("Explain quantum computing"):
print(chunk, end="", flush=True)
Agent API
The Agent API is available without a beta header.
run = exa.agent.runs.create(
query="Find engineering leaders at AI infrastructure companies that raised a Series A or B in the last 6 months.",
output_schema={
"type": "object",
"properties": {
"people": {
"type": "array",
"maxItems": 10,
"items": {
"type": "object",
"properties": {
"name": {"type": "string"},
"contact_email": {"type": "string", "format": "email"},
"linkedin_url": {"type": "string", "format": "uri"},
},
"required": ["name", "linkedin_url"],
},
}
},
"required": ["people"],
},
effort="auto",
)
run = exa.agent.runs.poll_until_finished(run.id)
print(run.output.structured if run.output else None)
For Agent Max, use the beta namespace and pass the beta token explicitly:
from exa_py import Exa
from exa_py.agent import AGENT_MAX_EFFORT_BETA
exa = Exa()
run = exa.beta.agent.runs.create(
query="Find all companies building browser automation tools in the United States.",
effort="max",
budget={"maxCostDollars": 10},
betas=[AGENT_MAX_EFFORT_BETA],
)
Async
from exa_py import AsyncExa
exa = AsyncExa(api_key="your-api-key")
results = await exa.search("async search example", contents={"highlights": True})
More
See the full documentation for all features including websets, filters, and advanced options.
9 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file exa_py-2.17.0.tar.gz.
File metadata
- Download URL: exa_py-2.17.0.tar.gz
- Upload date:
- Size: 64.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f2461f07668a2c702bc5d8cdd1aecbeb4529a1e2be55a4539427ad4acc09e6e0
|
|
| MD5 |
d4ee8bd17780a2eef93cfbd7a99ef434
|
|
| BLAKE2b-256 |
afb8a1a10d0a50b4a8532e021cc507d19479f2f673783758f895f12d9d180e25
|
File details
Details for the file exa_py-2.17.0-py3-none-any.whl.
File metadata
- Download URL: exa_py-2.17.0-py3-none-any.whl
- Upload date:
- Size: 87.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1754620db086bcedb44d11941a35b79e17d0e2b137010d3b4f2713a7f4b97199
|
|
| MD5 |
7ca649e4d381c4006b583cf4d61658c6
|
|
| BLAKE2b-256 |
f56cfc9f0422a6587ad1acb31de77f311975168232f5609116d27e5e3c0fd9da
|
