---
title: "List all Items for a Webset"
method: GET
path: "/v0/websets/{webset}/items"
tags: ["Items"]
---

# List all Items for a Webset

`GET /v0/websets/{webset}/items`

Returns a list of Webset Items.

You can paginate through the Items using the `cursor` parameter.

## Path parameters

- `webset` string, required

## Query parameters

- `cursor` string
- `limit` integer
- `sourceId` string

## Response `200`

Webset Items

- ListWebsetItemResponse
  - `data` WebsetItem[], required — The list of webset items
    - `id` string, required — The unique identifier for the Webset Item
    - `object` 'webset_item', required
    - `source` 'search' | 'import', required — The source of the Item
    - `sourceId` string, required — The unique identifier for the source
    - `sourceEntityId` string — The original identifier used to resolve this item (e.g., email, name, or URL). Only relevant when the source is import.
    - `scopeId` string — The import that sourced this item, when the item came from a scoped search with evaluate enabled on the import.
    - `websetId` string, required — The unique identifier for the Webset this Item belongs to.
    - `properties` union, required — The properties of the Item
      - WebsetItemPersonProperties
        - `type` 'person', required
        - `url` string, uri, required — The URL of the person profile
        - `description` string, required — Short description of the relevance of the person
        - `person` object, required
          - `name` string, required — The name of the person
          - `location` string, nullable, required — The location of the person
          - `position` string, nullable, required — The current work position of the person
          - `company` object, nullable, required
            - `name` string, required — The name of the company
            - `location` string, nullable, required — The location the person is working at the company
          - `pictureUrl` string, uri, nullable, required — The image URL of the person
          - `workHistory` object[], required — The work history of the person
            - `title` string, nullable, required — Job title or position
            - `location` string, nullable, required — Work location
            - `dates` object, nullable, required — Employment dates
              - …
            - `company` object, nullable, required
              - …
          - `educationHistory` object[], required — The education history of the person
            - `degree` string, nullable, required — Degree obtained
            - `dates` object, nullable, required — Education dates
              - …
            - `institution` object, nullable, required
              - …
      - WebsetItemCompanyProperties
        - `type` 'company', required
        - `url` string, uri, required — The URL of the company website
        - `description` string, required — Short description of the relevance of the company
        - `content` string, nullable, required — The text content of the company website
        - `company` object, required
          - `name` string, required — The name of the company
          - `location` string, nullable, required — The main location of the company
          - `employees` integer, nullable, required — The number of employees of the company
          - `industry` string, nullable, required — The industry of the company
          - `about` string, nullable, required — A short description of the company
          - `logoUrl` string, uri, nullable, required — The logo URL of the company
          - `foundedYear` number, nullable, required — The year the company was founded
          - `headquarters` object, nullable, required — The structured headquarters address of the company
            - `address` string, nullable, required — The street address of the headquarters
            - `city` string, nullable, required — The city of the headquarters
            - `state` string, nullable, required — The state or region of the headquarters
            - `postalCode` string, nullable, required — The postal code of the headquarters
            - `country` string, nullable, required — The country of the headquarters
            - `countryCode` string, nullable, required — The ISO country code of the headquarters
          - `financials` object, nullable, required — Financial information about the company
            - `revenueAnnual` number, nullable, required — The annual revenue of the company (USD)
            - `fundingTotal` number, nullable, required — The total funding raised by the company (USD)
            - `fundingLatestRound` object, nullable, required — The latest funding round
              - …
          - `webTraffic` object, nullable, required — Web traffic metrics for the company
            - `visitsMonthly` number, nullable, required — The estimated monthly website visits
            - `uniqueVisitors` number, nullable, required — The estimated monthly unique visitors
      - WebsetItemArticleProperties
        - `type` 'article', required
        - `url` string, uri, required — The URL of the article
        - `description` string, required — Short description of the relevance of the article
        - `content` string, nullable, required — The text content for the article
        - `article` object, required
          - `title` string, nullable, required — The title of the article
          - `author` string, nullable, required — The author(s) of the article
          - `publishedAt` string, nullable, required — The date and time the article was published
      - WebsetItemResearchPaperProperties
        - `type` 'research_paper', required
        - `url` string, uri, required — The URL of the research paper
        - `description` string, required — Short description of the relevance of the research paper
        - `content` string, nullable, required — The text content of the research paper
        - `researchPaper` object, required
          - `title` string, nullable, required — The title of the research paper
          - `author` string, nullable, required — The author(s) of the research paper
          - `publishedAt` string, nullable, required — The date and time the research paper was published
      - WebsetItemCustomProperties
        - `type` 'custom', required
        - `url` string, uri, required — The URL of the Item
        - `description` string, required — Short description of the Item
        - `content` string, nullable, required — The text content of the Item
        - `custom` object, required
          - `title` string, nullable, required — The title of the website
          - `author` string, nullable, required — The author(s) of the website
          - `publishedAt` string, nullable, required — The date and time the website was published
    - `evaluations` WebsetItemEvaluation[], required — The criteria evaluations of the item
      - `criterion` string, required — The description of the criterion
      - `reasoning` string, required — The reasoning for the result of the evaluation
      - `satisfied` 'yes' | 'no' | 'unclear', required — The satisfaction of the criterion
      - `references` object[] — The references used to generate the result.
        - `title` string, nullable, required — The title of the reference
        - `snippet` string, nullable, required — The relevant snippet of the reference content
        - `url` string, uri, required — The URL of the reference
    - `enrichments` EnrichmentResult[], nullable, required — The enrichments results of the Webset item
      - `object` 'enrichment_result', required
      - `status` 'pending' | 'completed' | 'canceled', required — The status of the enrichment result.
      - `format` 'text' | 'date' | 'number' | 'options' | 'email' | 'phone' | 'url', required
      - `result` string[], nullable, required — The result of the enrichment.
      - `reasoning` string, nullable, required — The reasoning for the result when an Agent is used.
      - `references` object[], required — The references used to generate the result.
        - `title` string, nullable, required — The title of the reference
        - `snippet` string, nullable, required — The relevant snippet of the reference content
        - `url` string, uri, required — The URL of the reference
      - `enrichmentId` string, required — The id of the Enrichment that generated the result
    - `createdAt` string, date-time, required — The date and time the item was created
    - `updatedAt` string, date-time, required — The date and time the item was last updated
  - `hasMore` boolean, required — Whether there are more Items to paginate through
  - `nextCursor` string, nullable, required — The cursor to paginate through the next set of Items

---

[API](https://skmtc.net/exa/apis/exa-public-api.md) · [All operations](https://skmtc.net/exa/apis/exa-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/exa/exa-public-api/versions/982a352e3781/schema)
