# Exa Similar

Blocks for finding semantically similar web pages using Exa's findSimilar API.

## Exa Find Similar

### What it is

Finds similar links using Exa's findSimilar API

### How it works

This block uses Exa's findSimilar API to discover web pages that are semantically similar to a given URL. The API analyzes the content and context of the provided page to find related content across the web.

The block supports filtering by domains, date ranges, and text patterns to refine results. You can retrieve content directly with results and enable content moderation to filter unsafe content.

### Inputs

| Input                  | Description                                                                                        | Type            | Required |
| ---------------------- | -------------------------------------------------------------------------------------------------- | --------------- | -------- |
| url                    | The url for which you would like to find similar links                                             | str             | Yes      |
| number\_of\_results    | Number of results to return                                                                        | int             | No       |
| include\_domains       | List of domains to include in the search. If specified, results will only come from these domains. | List\[str]      | No       |
| exclude\_domains       | Domains to exclude from search                                                                     | List\[str]      | No       |
| start\_crawl\_date     | Start date for crawled content                                                                     | str (date-time) | No       |
| end\_crawl\_date       | End date for crawled content                                                                       | str (date-time) | No       |
| start\_published\_date | Start date for published content                                                                   | str (date-time) | No       |
| end\_published\_date   | End date for published content                                                                     | str (date-time) | No       |
| include\_text          | Text patterns to include (max 1 string, up to 5 words)                                             | List\[str]      | No       |
| exclude\_text          | Text patterns to exclude (max 1 string, up to 5 words)                                             | List\[str]      | No       |
| contents               | Content retrieval settings                                                                         | ContentSettings | No       |
| moderation             | Enable content moderation to filter unsafe content from search results                             | bool            | No       |

### Outputs

| Output        | Description                                         | Type                    |
| ------------- | --------------------------------------------------- | ----------------------- |
| error         | Error message if the request failed                 | str                     |
| results       | List of similar documents with metadata and content | List\[ExaSearchResults] |
| result        | Single similar document result                      | ExaSearchResults        |
| context       | A formatted string of the results ready for LLMs.   | str                     |
| request\_id   | Unique identifier for the request                   | str                     |
| cost\_dollars | Cost breakdown for the request                      | CostDollars             |

### Possible use case

**Content Discovery**: Find related articles, blog posts, or resources similar to content you already like.

**Competitor Analysis**: Discover similar companies or products by finding pages similar to known competitors.

**Research Expansion**: Expand your research by finding additional sources similar to key reference materials.

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://agpt.co/docs/integrations/block-integrations/similar.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.