# Urlscan.io

{% hint style="info" %}
urlscan.io is a Threat Intelligence (TI) integration. TI Data Source integrations are used during investigations to improve analysis and in interactive chat to help answer questions. They are optional, but enabling more tooling integrations enhances Dropzone analysis.
{% endhint %}

The Dropzone AI Platform integrates with urlscan.io, a URL scanning tool. urlscan browses URls like a regular user and records the activity that this page navigation creates such as domains and IPs contacted, resources (JavaScript, CSS, etc) requested from those domains, etc.

## Create an API Key

urlscan.io requires an API key to enable.

To obtain an API Key, do the following:

* Create a free account [here](https://www.ipqualityscore.com/create-account), if you do not have one already
* In the banner on the left hand side of the urlscan.io homepage, navigate to Settings & API

<figure><img src="/files/NqzMFQBRNl4Ph6CpcZ13" alt=""><figcaption><p>Navigate to Settings &#x26; API</p></figcaption></figure>

* Click "Create API Key"

<figure><img src="/files/Xjnv7SnUfPR9d25cE1eK" alt=""><figcaption><p>Create API Key</p></figcaption></figure>

* Under "Description", write something memorable, such as "Dropzone AI Integration"

<figure><img src="/files/YGx1FivSk9Zu6iBL73aj" alt=""><figcaption><p>Create API Key</p></figcaption></figure>

* Click "Create API Key"
* Copy the API Key shown for use later in the Dropzone UI where it will be called API Key

<figure><img src="/files/xGnqbCdWezwF3zhRPLBB" alt=""><figcaption><p>Create API Key</p></figcaption></figure>

## Enable urlscan.io

To enable the Data Source integration, do the following:

* Navigate to your Dropzone AI tenant home page e.g. https\://*mycompany*.dropzone.app
* In the bottom left hand corner, click Settings > Integrations

<figure><img src="/files/zN02u3HObDaemUY8E1kD" alt=""><figcaption><p>Integrations Dropdown</p></figcaption></figure>

* Click "Available"

<figure><img src="/files/brI7n2Ux40Tk0jTwBCVh" alt=""><figcaption><p>Click Available</p></figcaption></figure>

* In the Search bar, search urlscan.io, then click "Configure"

<figure><img src="/files/Jzfmhdj16edArjxISx9x" alt=""><figcaption><p>The urlscan.io Data Tile</p></figcaption></figure>

* Input the API key
* Under "Visibility", select "Unlisted" or "Private"
  * View [urlscan's FAQ](https://urlscan.io/docs/faq/) for more information about the options

<figure><img src="/files/4yHk3OI7H2RcBdr3ed3a" alt=""><figcaption><p>The urlscan.io Data Source Configuration</p></figcaption></figure>

* Click "Test & Save" to finish

If you have any errors engage your Dropzone AI support representative.


---

# 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://docs.dropzone.ai/integrations/data/urlscan-io.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.