---
title: "Structure Search"
method: GET
path: "/api/v1/pro/result/{scanId}/similar/"
tags: ["Search"]
---

# Structure Search

`GET /api/v1/pro/result/{scanId}/similar/`

## Request

- Base URL: `https://urlscan.io`
- URL: `https://urlscan.io/api/v1/pro/result/{scanId}/similar/`
- Auth: API key in header `api-key`

**urlscan Pro** - Get structurally similar results to a specific scan. See
description for this propietary feature on [urlscan
Pro](https://pro.urlscan.io/help/structuresearch).

## Path parameters

- `scanId` string, required

## Query parameters

- `q` string
- `size` integer
- `search_after` string

## Response `200`

OK

- SearchResponse
  - `results` object[]: Array of search results. Scans by default; other datasources return their own document types.
    - `_id` string
    - `page` object
    - `verdicts` object
    - `submitter` object
    - `stats` object
    - `scanner` object
    - `task` object
    - `labels` string[]
    - `usertags` string[]
    - `meta` object[]
    - `files` object[]
    - `brand` object[]
    - `screenshot` string
    - `result` string
    - `image` object
    - `visible` object
    - `canonical` object
    - `dom` object
    - `text` object
    - `links` object
    - `frames` object
    - `websockets` object
    - `clipboard` object
    - `annotations` object
    - `vectors` object
    - `_score` number, nullable
    - `sort` unknown[]: Sort values of this result (numbers or strings), used for paging with `search_after`.
      - unknown
  - `total` integer: Total number of results with an exact count up to 10,000 results.
  - `took` integer: Search request time in milliseconds.
  - `has_more` boolean: True if there are more than 10,000 results.
  - `search_date_limit_days` integer: Maximum number of days the search will go back. Only present if the search history is limited, which applies to unauthenticated requests and free users.

## Changes

- **2026-10-05** `253f254d560b`: 1 info
  - added the optional property `search_date_limit_days` to the response with the `200` status

[Operation history](https://skmtc.dev/urlscan/apis/urlscan-io-apis/changes/api/v1/pro/result/:scanId/similar/get.md)

---

[API](https://skmtc.dev/urlscan/apis/urlscan-io-apis.md) - [All operations](https://skmtc.dev/urlscan/apis/urlscan-io-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/urlscan/apis/urlscan-io-apis/revisions/868c1c89a6e8?raw)