Find similar links

Get your Exa API key

Authorizations

Authorization

string

header

required

API key can be provided either via x-api-key header or Authorization header with Bearer scheme

Body

application/json

url

string

required

The url for which you would like to find similar links.

numResults

integer

default:

Number of results to return (up to thousands of results available for custom plans)

Required range: x < 100

includeDomains

string[]

List of domains to include in the search. If specified, results will only come from these domains.

excludeDomains

string[]

List of domains to exclude from search results. If specified, no results will be returned from these domains.

startCrawlDate

string

Crawl date refers to the date that Exa discovered a link. Results will include links that were crawled after this date. Must be specified in ISO 8601 format.

endCrawlDate

string

Crawl date refers to the date that Exa discovered a link. Results will include links that were crawled before this date. Must be specified in ISO 8601 format.

startPublishedDate

string

Only links with a published date after this will be returned. Must be specified in ISO 8601 format.

endPublishedDate

string

Only links with a published date before this will be returned. Must be specified in ISO 8601 format.

includeText

string[]

List of strings that must be present in webpage text of results. Currently, only 1 string is supported, of up to 5 words.

excludeText

string[]

List of strings that must not be present in webpage text of results. Currently, only 1 string is supported, of up to 5 words.

contents

object

Response

200 - application/json

requestId

string

Unique identifier for the request

results

object[]

A list of search results containing title, URL, published date, author, and score.

results.title

string

The title of the search result.

results.url

string

The URL of the search result.

results.publishedDate

string | null

An estimate of the creation date, from parsing HTML content. Format is YYYY-MM-DD.

results.author

string | null

If available, the author of the content.

results.score

number | null

A number from 0 to 1 representing similarity between the query/url and the result.

results.id

string

The temporary ID for the document. Useful for /contents endpoint.

results.image

string

The URL of an image associated with the search result, if available.

results.favicon

string

The URL of the favicon for the search result's domain.

results.text

string

The full content text of the search result.

results.highlights

string[]

Array of highlights extracted from the search result content.

results.highlightScores

number[]

Array of cosine similarity scores for each highlighted

results.summary

string

Summary of the webpage

results.subpages

object[]

Array of subpages for the search result.

results.subpages.title

string

The title of the search result.

results.subpages.url

string

The URL of the search result.

results.subpages.publishedDate

string | null

An estimate of the creation date, from parsing HTML content. Format is YYYY-MM-DD.

results.subpages.author

string | null

If available, the author of the content.

results.subpages.score

number | null

A number from 0 to 1 representing similarity between the query/url and the result.

results.subpages.id

string

The temporary ID for the document. Useful for /contents endpoint.

results.subpages.image

string

The URL of an image associated with the search result, if available.

results.subpages.favicon

string

The URL of the favicon for the search result's domain.

results.subpages.text

string

The full content text of the search result.

results.subpages.highlights

string[]

Array of highlights extracted from the search result content.

results.subpages.highlightScores

number[]

Array of cosine similarity scores for each highlighted

results.subpages.summary

string

Summary of the webpage

results.subpages.subpages

object[]

Array of subpages for the search result.

results.subpages.subpages.title

string

The title of the search result.

results.subpages.subpages.url

string

The URL of the search result.

results.subpages.subpages.publishedDate

string | null

An estimate of the creation date, from parsing HTML content. Format is YYYY-MM-DD.

results.subpages.subpages.author

string | null

If available, the author of the content.

results.subpages.subpages.score

number | null

A number from 0 to 1 representing similarity between the query/url and the result.

results.subpages.subpages.id

string

The temporary ID for the document. Useful for /contents endpoint.

results.subpages.subpages.image

string

The URL of an image associated with the search result, if available.

results.subpages.subpages.favicon

string

The URL of the favicon for the search result's domain.

results.subpages.subpages.text

string

The full content text of the search result.

results.subpages.subpages.highlights

string[]

Array of highlights extracted from the search result content.

results.subpages.subpages.highlightScores

number[]

Array of cosine similarity scores for each highlighted

results.subpages.subpages.summary

string

Summary of the webpage

results.subpages.subpages.subpages

object[]

Array of subpages for the search result.

results.subpages.subpages.extras

object

Results from extras.

results.subpages.extras

object

Results from extras.

results.extras

object

Results from extras.

costDollars

object

Getting Started

API Reference

RAG Quick Start Guide

Concepts

Admin

Find similar links

Get your Exa API key

Authorizations

Body

Response