Python SDK for Exa API.
Project description
Exa
Exa API in Python
Installation
pip install exa_py
Usage
Import the package and initialize the Exa client with your API key:
from exa_py import Exa
exa = Exa(api_key="your-api-key")
Common requests
# basic search
results = exa.search("This is a Exa query:")
# keyword search (non-neural)
results = exa.search("Google-style query", type="keyword")
# search with date filters
results = exa.search("This is a Exa query:", start_published_date="2019-01-01", end_published_date="2019-01-31")
# search with domain filters
results = exa.search("This is a Exa query:", include_domains=["www.cnn.com", "www.nytimes.com"])
# search and get text contents
results = exa.search_and_contents("This is a Exa query:")
# search and get contents with contents options
results = exa.search_and_contents("This is a Exa query:",
text={"include_html_tags": True, "max_characters": 1000})
# find similar documents
results = exa.find_similar("https://example.com")
# find similar excluding source domain
results = exa.find_similar("https://example.com", exclude_source_domain=True)
# find similar with contents
results = exa.find_similar_and_contents("https://example.com", text=True)
# get text contents
results = exa.get_contents(["tesla.com"])
# get contents with contents options
results = exa.get_contents(["urls"],
text={"include_html_tags": True, "max_characters": 1000})
# basic answer
response = exa.answer("This is a query to answer a question")
# answer with full text
response = exa.answer("This is a query to answer a question", text=True)
# answer with streaming
response = exa.stream_answer("This is a query to answer:")
# Print each chunk as it arrives when using the stream_answer method
for chunk in response:
print(chunk, end='', flush=True)
# research task example – answer a question with citations
# Example prompt & schema inspired by the TypeScript example.
QUESTION = (
"Summarize the history of San Francisco highlighting one or two major events "
"for each decade from 1850 to 1950"
)
OUTPUT_SCHEMA: Dict[str, Any] = {
"type": "object",
"required": ["timeline"],
"properties": {
"timeline": {
"type": "array",
"items": {
"type": "object",
"required": ["decade", "notableEvents"],
"properties": {
"decade": {
"type": "string",
"description": 'Decade label e.g. "1850s"',
},
"notableEvents": {
"type": "string",
"description": "A summary of notable events.",
},
},
},
},
},
}
resp = exa.research.create_task(
instructions=QUESTION,
model="exa-research",
output_schema=OUTPUT_SCHEMA,
)
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
exa_py-1.14.14.tar.gz
(32.5 kB
view details)
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
exa_py-1.14.14-py3-none-any.whl
(42.0 kB
view details)
File details
Details for the file exa_py-1.14.14.tar.gz.
File metadata
- Download URL: exa_py-1.14.14.tar.gz
- Upload date:
- Size: 32.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/2.1.3 CPython/3.13.5 Darwin/24.5.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0a08a090c78bb32683f9378946aa428526d8b1f6bdaee0476be5baefbab1f868
|
|
| MD5 |
ae067e8c53c69d75c79bf1c6a60f1395
|
|
| BLAKE2b-256 |
b90c3f0dfbc9d350c71c9ff210894625deaf9c711fb1c2b99b0c83f0c2906b9b
|
File details
Details for the file exa_py-1.14.14-py3-none-any.whl.
File metadata
- Download URL: exa_py-1.14.14-py3-none-any.whl
- Upload date:
- Size: 42.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/2.1.3 CPython/3.13.5 Darwin/24.5.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3859378a2b214f73f56a3ad4e29a7cd72464c49ff56ba704d28637fa349146c4
|
|
| MD5 |
32158de148f8150683bc68da29f21aee
|
|
| BLAKE2b-256 |
a372f13440f124cca0ab54a42ae4eef8d6eb1c0f341000cfc083f7b160cc4b3a
|
