---
title: "List"
method: GET
path: "/list"
tags: ["List"]
---

# List

`GET /list`

Automatically structures a list of items from news index pages, product listings pages, search engine results pages, and other "list-like" pages.

## Query parameters

- `url` string, required
- `fields` 'links' | 'extlinks' | 'meta' | 'querystring' | 'breadcrumb'
- `timeout` integer
- `callback` string
- `proxy` string
- `proxyAuth` string
- `useProxy` string
- `renderDelay` integer
- `scroll` 'slow' | 'fast'

## Response `200`

Successful API Response

- object
  - `request` object
    - `pageUrl` string
    - `api` string
    - `version` integer
  - `objects` object[]
    - `diffbotUri` string
    - `icon` string
    - `pageUrl` string
    - `type` string
    - `title` string
    - `items` object[]
      - `date` string
      - `summary` string
      - `link` string
      - `title` string

## Other responses

- `500` — Internal Server Error

---

[API](https://skmtc.dev/diffbot/apis/web-search.md) · [All operations](https://skmtc.dev/diffbot/apis/web-search/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/diffbot/web-search/revisions/8b88d7dabe63/schema)