- Python
- TypeScript
Python
Copy
Ask AI
from exa_py import Exa
# instantiate the Exa client
exa = Exa("YOUR API KEY")
# basic search (returns contents by default)
results = exa.search("This is an Exa query:")
# search with highlights (recommended for agentic workflows)
results = exa.search("This is an Exa query:", highlights={"max_characters": 4000})
# search with date filters
results = exa.search("This is an Exa query:", start_published_date="2019-01-01", end_published_date="2019-01-31")
# search with domain filters
results = exa.search("This is an Exa query:", include_domains=["www.cnn.com", "www.nytimes.com"])
# search with custom contents options
results = exa.search("This is an Exa query:",
text={"include_html_tags": True, "max_characters": 1000},
highlights={"max_characters": 4000, "query": "This is the highlight query:"})
# 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("https://example.com", text=True, highlights={"max_characters": 4000})
# get text contents
results = exa.get_contents(["ids"])
# get highlights
results = exa.get_contents(["ids"], highlights={"max_characters": 4000})
# get contents with contents options
results = exa.get_contents(["ids"],
text={"include_html_tags": True, "max_characters": 1000},
highlights={"max_characters": 4000, "query": "This is the highlight query:"})
# 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)
Copy
Ask AI
import Exa from 'exa-js';
// Instantiate the Exa client
const exa = new Exa("YOUR API KEY");
// Basic search (returns contents by default)
const basicResults = await exa.search("This is an Exa query:");
// Search with highlights (recommended for agentic workflows)
const highlightResults = await exa.search("This is an Exa query:", {
highlights: { maxCharacters: 4000 }
});
// Search with date filters
const dateFilteredResults = await exa.search("This is an Exa query:", {
startPublishedDate: "2019-01-01",
endPublishedDate: "2019-01-31"
});
// Search with domain filters
const domainFilteredResults = await exa.search("This is an Exa query:", {
includeDomains: ["www.cnn.com", "www.nytimes.com"]
});
// Search with custom contents options
const customContentsResults = await exa.search("This is an Exa query:", {
text: { includeHtmlTags: true, maxCharacters: 1000 },
highlights: { maxCharacters: 4000, query: "This is the highlight query:" }
});
// Find similar documents
const similarResults = await exa.findSimilar("https://example.com");
// Find similar excluding source domain
const similarExcludingSourceResults = await exa.findSimilar("https://example.com", { excludeSourceDomain: true });
// Find similar with contents
const similarWithContentsResults = await exa.findSimilar("https://example.com", {
text: true,
highlights: { maxCharacters: 4000 }
});
// Get text contents
const textContentsResults = await exa.getContents(["ids"]);
// Get highlights
const highlightsContentsResults = await exa.getContents(["ids"], {
highlights: { maxCharacters: 4000 }
});
// Get contents with contents options
const customGetContentsResults = await exa.getContents(["ids"], {
text: { includeHtmlTags: true, maxCharacters: 1000 },
highlights: { maxCharacters: 4000, query: "This is the highlight query:" }
});
// Get answer to a question with citation contents
const answerWithTextResults = await exa.answer("What is the population of New York City?", {
text: true
});
// Get answer to a question with streaming
for await (const chunk of exa.streamAnswer("What is the population of New York City?")) {
if (chunk.content) {
process.stdout.write(chunk.content);
}
if (chunk.citations) {
console.log("\nCitations:", chunk.citations);
}
}