> For the complete documentation index, see [llms.txt](https://help.listly.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.listly.io/getting-started/extension-features/deep-extract.md).

# Deep extract

## What is Deep Extract?

Deep Extract is a feature that lets you **extract data from multiple detail pages at once**, right in your web browser without going through a server.

{% hint style="success" %}
**Quick Start**

➡️ Click the Listly icon on the page you want ➡️ Select Deep Extract ➡️ Collect detail page addresses ➡️ Select the extraction areas within a detail page ➡️ Click the start extraction button ➡️ Select the tab to extract in the results ➡️ Download your Excel file
{% endhint %}

## How to use

{% stepper %}
{% step %}

## Click Listly on a list page and select **Deep Extract**

On a list page that links to detail pages, click the [installed Listly extension](https://help.listly.io/~/revisions/p61hN2MZx0MtKH3DVnIJ/getting-started/quick-start-guide/how-to-install-listly) icon. In the Listly extension, select **\[Deep Extract]**.

<figure><img src="https://3090065457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoHfMCeMlqJPW61OR5d1%2Fuploads%2FsjT9hPhbAdqBHXUHKOZi%2F%E1%84%89%E1%85%B5%E1%86%B7%E1%84%8E%E1%85%B3%E1%86%BC%E1%84%8E%E1%85%AE%E1%84%8E%E1%85%AE%E1%86%AF-1.png?alt=media&amp;token=54317657-b658-47db-ac5e-27701ba18854" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

## Collect detail page addresses

Select an item on the list page. When you click an address area with a repeating pattern, a popup appears that lets you automatically select the entire matching area.

<figure><img src="https://3090065457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoHfMCeMlqJPW61OR5d1%2Fuploads%2FwaXtWsVS9JK9YakuoOa6%2F%E1%84%89%E1%85%B5%E1%86%B7%E1%84%8E%E1%85%B3%E1%86%BC%E1%84%8E%E1%85%AE%E1%84%8E%E1%85%AE%E1%86%AF-2.png?alt=media&amp;token=a793b2cb-5e33-420d-a1a6-c19e46054a04" alt=""><figcaption></figcaption></figure>

* If the detail pages you want to extract share the same pattern, click **\[Select together]**. In most cases, clicking this option automatically selects all the detail pages at once.
* If the areas you want to extract are separate, individual detail pages that don't share a pattern, click the **\[Select individually]** button.

<figure><img src="https://3090065457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoHfMCeMlqJPW61OR5d1%2Fuploads%2FpbKR4JQqCv7r8ERfVAVK%2F%E1%84%89%E1%85%B5%E1%86%B7%E1%84%8E%E1%85%B3%E1%86%BC%E1%84%8E%E1%85%AE%E1%84%8E%E1%85%AE%E1%86%AF-3.png?alt=media&amp;token=7d5211a4-776a-42ed-87ab-3650b1150c5c" alt=""><figcaption></figcaption></figure>

Once you've collected all the detail page addresses, click the **\[Next]** button.

<figure><img src="https://3090065457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoHfMCeMlqJPW61OR5d1%2Fuploads%2F4J27RH8CaIKI4xBvcGFQ%2F%E1%84%89%E1%85%B5%E1%86%B7%E1%84%8E%E1%85%B3%E1%86%BC%E1%84%8E%E1%85%AE%E1%84%8E%E1%85%AE%E1%86%AF-4.png?alt=media&amp;token=0cd2d03f-b112-4090-8913-604cf88975e0" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

## Set the interval between page loads

Before selecting the extraction areas, you can set the interval for visiting each detail page. If the pages contain a lot of information or your internet connection is unstable, set the interval a little longer than the default of 0.5 seconds.

<figure><img src="https://3090065457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoHfMCeMlqJPW61OR5d1%2Fuploads%2FHU5p3Y7UIicvF1GH1tYJ%2F%E1%84%89%E1%85%B5%E1%86%B7%E1%84%8E%E1%85%B3%E1%86%BC%E1%84%8E%E1%85%AE%E1%84%8E%E1%85%AE%E1%86%AF-5.png?alt=media&amp;token=6e54c4fd-a159-42a1-8e52-464c03a93c58" alt=""><figcaption></figcaption></figure>

Once you're done, click the **\[Set area]** button.

<figure><img src="https://3090065457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoHfMCeMlqJPW61OR5d1%2Fuploads%2FcheLWyu4dp0Vi1ZRClE6%2F%E1%84%89%E1%85%B5%E1%86%B7%E1%84%8E%E1%85%B3%E1%86%BC%E1%84%8E%E1%85%AE%E1%84%8E%E1%85%AE%E1%86%AF-6.png?alt=media&amp;token=6df11fa2-df57-44a3-9332-ceec9ed74ea6" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## Select the areas on the detail page

When the first detail page from your collected addresses opens, select the areas you want to extract on the page. Just like with [Extract Part](https://help.listly.io/~/revisions/p61hN2MZx0MtKH3DVnIJ/getting-started/extension-features/extract-part), you can click only the areas you want with your mouse to extract them.

Once you've selected all the extraction areas, click the **\[Start extraction]** button.

<figure><img src="https://3090065457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoHfMCeMlqJPW61OR5d1%2Fuploads%2FIuobIpyv6BR5tDE5ofgW%2F%E1%84%89%E1%85%B5%E1%86%B7%E1%84%8E%E1%85%B3%E1%86%BC%E1%84%8E%E1%85%AE%E1%84%8E%E1%85%AE%E1%86%AF-7.png?alt=media&amp;token=e99769e1-5a65-4a97-96d2-6f5a37160c31" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## Keep the screen open until extraction is complete

Keep the current screen open until extraction is finished.

<figure><img src="https://3090065457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoHfMCeMlqJPW61OR5d1%2Fuploads%2FS9Ju7QzzJt5Wu9BeJEvJ%2F%E1%84%89%E1%85%B5%E1%86%B7%E1%84%8E%E1%85%B3%E1%86%BC%E1%84%8E%E1%85%AE%E1%84%8E%E1%85%AE%E1%86%AF-8.png?alt=media&amp;token=7b27b1d1-d31c-4a2a-b6b7-1d4c9359380b" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## Check the extraction results

Once extraction is complete, click the **\[View Results]** button.

<figure><img src="https://3090065457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoHfMCeMlqJPW61OR5d1%2Fuploads%2FMD6zkRRtYnt9Igx1HQN0%2F%E1%84%89%E1%85%B5%E1%86%B7%E1%84%8E%E1%85%B3%E1%86%BC%E1%84%8E%E1%85%AE%E1%84%8E%E1%85%AE%E1%86%AF-9.png?alt=media&amp;token=ef8d5ab6-5a62-40fd-baf7-6297097f7249" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## Review the results and download

On the results screen, scroll down and find the tab where your selected data was collected.

<figure><img src="https://3090065457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoHfMCeMlqJPW61OR5d1%2Fuploads%2FhRIClfIOZnHF3MWH7XBD%2F%E1%84%89%E1%85%B5%E1%86%B7%E1%84%8E%E1%85%B3%E1%86%BC%E1%84%8E%E1%85%AE%E1%84%8E%E1%85%AE%E1%86%AF-10.png?alt=media&amp;token=75aeccb8-3f19-4522-91e4-d64bb28dad35" alt=""><figcaption></figcaption></figure>

<mark style="color:$danger;">❶</mark> When you extract multiple pages at once, as with Deep Extract, the output from each page goes into a single folder. If you want to download the data from all the pages as one sheet, this area needs to be set to **\[Whole folder]**.

<mark style="color:$danger;">❷</mark> Use the **Data Layout** option to preview how the data will be arranged in the Excel file. Choose the layout that works best, then click the **\[Excel]** or **\[Google Sheets]** button to export the data.

<figure><img src="https://3090065457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoHfMCeMlqJPW61OR5d1%2Fuploads%2Fj4MfHD6xh9zadEPa3XQz%2F%E1%84%89%E1%85%B5%E1%86%B7%E1%84%8E%E1%85%B3%E1%86%BC%E1%84%8E%E1%85%AE%E1%84%8E%E1%85%AE%E1%86%AF-11.png?alt=media&amp;token=85ab04b9-7cf6-4986-bb8c-e206cec939b3" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Note: [Learn more about data download options](https://help.listly.io/~/revisions/yRHwykV7dee2YdkkOZSQ/getting-started/result-page-features/data-download-options)
{% endhint %}
{% endstep %}

{% step %}

## Check the result file

Open the downloaded file to check it.

<figure><img src="https://3090065457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoHfMCeMlqJPW61OR5d1%2Fuploads%2FNLOCArPo4sTq169IlW8S%2Fimage.png?alt=media&amp;token=5028c37b-1f93-41bf-9e6a-6c9d3762cf92" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.listly.io/getting-started/extension-features/deep-extract.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.