Skip to content
telipot
telipot
Join the waitlistSign in

Web pages similar to a URL, with titles and scores.

Find links similar to the provided URL and optionally retrieve their contents. Deprecated: prefer `/search` with a query describing the source.

Job web.page.similar

Your AI asks

checks the price first
telipot run exa.web.page.similar \
  --input-json '{"url":"https://example.com","numResults":1}' \
  --quote

Price

Price unknown
Priced· before it runs

exa.web.page.similar

Price unknownYour plan

Whose account it uses

1The person asking
not needed
2Your company’s Exa plan
Selected identity for this example
3Our account
not used

What it sends

{
  "url": "https://example.com",
  "numResults": 1
}

Your Exa login is added for you. Your AI never sees it.

What it costs

Unknown

not listed, never free

sourcedocs · exa.ai/docs/admin/pricing · checked 2026-10-05
confidenceunknown
settles onThe charge Exa reports in costDollars.total
noteThe pricing page lists no rate for this route, and the vendor's OpenAPI document marks it deprecated, so no price is recorded; the response reports its charge in costDollars.total.

Preview the price first. --quote runs nothing.

For developers · run it

Shell · runs the task on the named account

telipot run exa.web.page.similar \
  --input-json '{"url":"https://example.com","numResults":1}'

url

string · required · at least 3

The url for which you would like to find similar links. The vendor marks this route deprecated in its OpenAPI document and prefers /search with a query describing the source.

numResults

integer · 1 to 100 · default 10

Number of results to return. The maximum public limit is 100 results; contact sales (hello@exa.ai) for more.

excludeSourceDomain

boolean

If true, results from the same domain as the source url are excluded.

includeDomains

array · at most 1200

Domains or domain paths to search, each a hostname such as example.com, a hostname with a path prefix such as example.com/docs, or a wildcard subdomain such as *.example.com.

excludeDomains

array · at most 1200

Domains or domain paths to leave out, in the same forms as includeDomains.

startPublishedDate

string

Only links with a published date after this are returned. ISO 8601 date-time.

endPublishedDate

string

Only links with a published date before this are returned. ISO 8601 date-time.

category

string

A data category to focus on. Known categories are company, publication, news, personal site, financial report and people; other strings are accepted as category hints. The company and people categories do not support startPublishedDate, endPublishedDate or excludeDomains, and using them returns a 400.

contents

object

What to return for each result, nested under this field, such as { highlights: true } or { text: { maxCharacters: 2000 } }. Without it each result carries metadata such as title, URL and publication date.

requestId

string

results

object[]

searchTime

number

Server-side processing time in milliseconds

costDollars

object

Estimated dollar cost of the completed request; billing is computed from usage counters, not from this object.
Full output schema · JSONNested fields and constraints

Output JSON Schema

{
  "type": "object",
  "properties": {
    "requestId": {
      "type": "string"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title",
          "url"
        ],
        "properties": {
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "id": {
            "type": "string",
            "description": "Temporary document id, accepted by the contents route"
          },
          "publishedDate": {
            "type": "string",
            "description": "Estimated creation date parsed from the page"
          },
          "author": {
            "type": [
              "string",
              "null"
            ]
          },
          "image": {
            "type": "string"
          },
          "favicon": {
            "type": "string"
          },
          "text": {
            "type": "string",
            "description": "Full page text, present only when requested"
          },
          "highlights": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "summary": {
            "type": "string"
          },
          "subpages": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "entities": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "extras": {
            "type": "object"
          },
          "score": {
            "type": "number",
            "description": "Similarity to the source URL; compare scores only within one response"
          }
        }
      }
    },
    "searchTime": {
      "type": "number",
      "description": "Server-side processing time in milliseconds"
    },
    "costDollars": {
      "type": "object",
      "description": "Estimated dollar cost of the completed request; billing is computed from usage counters, not from this object.",
      "properties": {
        "total": {
          "type": "number"
        },
        "search": {
          "type": "object",
          "properties": {
            "neural": {
              "type": "number"
            },
            "keyword": {
              "type": "number"
            }
          }
        },
        "summary": {
          "type": "number"
        },
        "contents": {
          "type": "object",
          "properties": {
            "text": {
              "type": "number"
            },
            "highlights": {
              "type": "number"
            },
            "summary": {
              "type": "number"
            }
          }
        }
      }
    }
  }
}

A real answer

examples/exa.web.page.similar.json

{
  "requestId": "2b29b669e9b8fc7c24055fcdb003cefb",
  "results": [
    {
      "id": "https://example.re/",
      "title": "Hello World!",
      "url": "https://example.re/",
      "author": null,
      "score": 0.8696224689483643
    }
  ],
  "costDollars": {
    "total": 0.004,
    "search": {
      "neural": 0.004
    }
  },
  "searchTime": 186.05773100000806
}