Wappalyzer

https://www.wappalyzer.com/docs
Admin
Wappalyzer is an intelligence platform that provides APIs for website, company, and email data...
Tokens:26,852
Snippets:146
Trust Score:10
Update:1 week ago
Show doc for...
Tokens:
Raw
### Install and run local Wappalyzer MCP server

Source: https://www.wappalyzer.com/docs/integrations/mcp

Clones the wappalyzer/mcp repository, installs dependencies, and starts the server with the WAPPALYZER_API_KEY environment variable. Requires Node.js 20 or newer and a valid API key.

```bash
git clone https://github.com/wappalyzer/mcp.git
cd mcp
npm install
WAPPALYZER_API_KEY=your_api_key npx wappalyzer-mcp
```

--------------------------------

### Credit balance response example

Source: https://www.wappalyzer.com/docs/api

Example JSON response from the credit balance endpoint, showing the credits field.

```json
{
  "credits": 100000
}
```

--------------------------------

### Response: Live lookup with technology details

Source: https://www.wappalyzer.com/docs/api/v2/lookup

Example response for a live lookup showing detected technology details for the requested URL.

```json
[
  {
    "url": "https://example.com",
    "technologies": [
      {
        "slug": "craft-cms",
        "name": "Craft CMS",
        "cpe": "cpe:2.3:a:craftcms:craft_cms:*:*:*:*:*:*:*:*",
        "versions": [
          "3.0.0"
        ],
        "categories": [
          {
            "id": 1,
            "slug": "cms",
            "name": "CMS"
          }
        ]
      }
    ]
  }
]
```

--------------------------------

### cURL request to check credit balance

Source: https://www.wappalyzer.com/docs/api

Example cURL command to GET the credit balance endpoint. Requires an API key in the x-api-key header.

```bash
curl -H "x-api-key: <your api key>" "https://api.wappalyzer.com/v2/credits/balance/"
```

--------------------------------

### Response: Async lookup initiation

Source: https://www.wappalyzer.com/docs/api/v2/lookup

Example response for the asynchronous lookup request, showing that crawl has been initiated for each URL.

```json
[
  {
    "url": "https://example.com",
    "crawl": true // Crawl initiated
  },
  {
    "url": "https://example.org",
    "crawl": true // Crawl initiated
  }
]
```

--------------------------------

### Example response for subdomain finder

Source: https://www.wappalyzer.com/docs/api/v2/subdomains

Shows the JSON response structure with the requested domain, a list of subdomains with timestamps, and a moreAfter field for pagination.

```json
[
  {
    "domain": "example.com",
    "subdomains": {
      "status.example.com": {
        "createdAt": 1670285563,
        "updatedAt": 1675604779
      },
      ...
      "shop.example.com": {
        "createdAt": 1670285563,
        "updatedAt": 1675604779
      }
    },
    "moreAfter": "shop.example.com"
  }
]
```

--------------------------------

### Response: Lookup with company and contact sets

Source: https://www.wappalyzer.com/docs/api/v2/lookup

Example response including company and contact details as requested via the sets parameter.

```json
[
  {
    "url": "https://www.wappalyzer.com",
    "technologies": [
      {
        "slug": "stripe",
        "name": "Stripe",
        "versions": [ "3" ],
        "categories": [
          {
            "id": 1,
            "slug": "payment-processors",
            "name": "Payment processors"
          }
        ],
        "trafficRank": 1000,
        "confirmedAt": 1612824037
      },
      ...
    ],
    "email": [ "example@wappalyzer.com" ],
    "verifiedEmail": [ "example@wappalyzer.com" ],
    "safeEmail": [ "example@wappalyzer.com" ],
    "phone": [ "+61 ..." ],
    "companyName": "Wappalyzer",
    "inferredCompanyName": "WAPPALYZER",
    "industry": "Internet",
    "about": "Wappalyzer uncovers the technologies used on websites.",
    "locations": [ "Melbourne, VIC 3000, AU" ],
    "companySize": "2-10 employees",
    "companyType": "Privately Held",
    "companyFounded": 2008,
    "employees": [
      {
        "name": "Elbert Alias",
        "title": "Founder of Wappalyzer"
      },
      ...
    ]
  }
]
```

--------------------------------

### GET /v2/credits/balance/

Source: https://www.wappalyzer.com/docs/api

Retrieves the current credit balance for the authenticated account. Use this endpoint to check available credits before starting a job.

```APIDOC
## GET /v2/credits/balance/

### Description
Retrieves the current credit balance for the authenticated account. Use this endpoint to check available credits before starting a job.

### Method
GET

### Endpoint
https://api.wappalyzer.com/v2/credits/balance/

### Authentication
Requires an API key sent in the `x-api-key` header.

### Request Example
```
curl -H "x-api-key: <your api key>" "https://api.wappalyzer.com/v2/credits/balance/"
```

### Response
#### Success Response (200)
- **credits** (integer) - The number of credits remaining.

#### Response Example
```
{
  "credits": 100000
}
```
```

--------------------------------

### GET /v2/lists/

Source: https://www.wappalyzer.com/docs/api/v2/lists

Returns the lead lists you have created so you can monitor status, pricing, and available results. This endpoint is synchronous and requires a Business plan.

```APIDOC
## GET /v2/lists/

### Description
Returns the lead lists you have created so you can monitor status, pricing, and available results.

### Method
GET

### Endpoint
https://api.wappalyzer.com/v2/lists/

### Parameters
#### Headers
- **x-api-key** (string) - Required - Your API key.

### Request Example
```
curl -H "x-api-key: <your api key>" "https://api.wappalyzer.com/v2/lists/"
```

### Response
#### Success Response (200)
- **id** (string) - The list's unique identifier.
- **createdAt** (integer) - List creation date as a UNIX timestamp.
- **status** (string) - List status. One of `Calculating`, `Ready`, `Failed`, `Insufficient` or `Complete`.
- **totalCredits** (integer) - The price of the list in credits.
- **technologies** (array) - Array of technologies.
- **keywords** (array) - Array of keywords.
- **rows** (integer) - The total number of results in the list per technology.

#### Response Example
```
[
  {
    "id": "lst_abcdef",
    "createdAt": 1620687647,
    "status": "Ready",
    "totalCredits": 1000,
    "technologies": [
      {
        "slug": "shopify",
        "name": "Shopify",
        "categories": [
          {
            "slug": "ecommerce",
            "name": "Ecommerce"
          }
        ],
        "operator": "=",
        "version": null
      }
    ],
    "keywords": [],
    "rows": 1000
  }
]
```

### Properties
- **Execution**: Synchronous
- **Request timeout**: 20 seconds
- **Rate limit**: 10 requests per second
- **Pricing**: Free
```

--------------------------------

### GET /v2/verify/

Source: https://www.wappalyzer.com/docs/api/v2/verify

Verifies an email address and returns detailed information about its validity, reachability, and other attributes. Requires a Business plan and an API key.

```APIDOC
## [GET] https://api.wappalyzer.com/v2/verify/

### Description
Verifies an email address and returns detailed information about its validity, reachability, and other attributes. Requires a Business plan and an API key.

### Method
GET

### Endpoint
https://api.wappalyzer.com/v2/verify/

### Parameters
#### Query Parameters
- **email** (string) - Required - Email address to verify (e.g. `info@example.com`).

### Request Example
```
curl -H "x-api-key: <your api key>" "https://api.wappalyzer.com/v2/verify/?email=info@example.com"
```

### Response
#### Success Response (200)
- **email** (string) - The input email address.
- **domain** (string) - The domain portion of the email address.
- **reachable** (string) - One of `safe`, `risky`, `invalid` or `unknown`.
- **disposable** (boolean) - Whether the email address is from a known disposable email provider.
- **roleAccount** (boolean) - Whether the email address is a role account (e.g., admin@example.com).
- **mxValid** (boolean) - Whether the domain has valid MX DNS records.
- **connection** (boolean) - Whether the SMTP server accepts connections.
- **inboxFull** (boolean) - Whether the recipient's inbox is full.
- **catchAll** (boolean) - Whether the email address is a catch-all address.
- **deliverable** (boolean) - Whether emails to this address are deliverable.
- **disabled** (boolean) - Whether the recipient's inbox is disabled.
- **syntaxValid** (boolean) - Whether the email address is syntactically valid.

#### Response Example
```
{
  "email": "info@example.com",
  "domain": "example.com",
  "reachable": "risky",
  "disposable": false,
  "roleAccount": true,
  "mxValid": true,
  "connection": true,
  "inboxFull": false,
  "catchAll": false,
  "deliverable": true,
  "disabled": false,
  "syntaxValid": true
}
```
```

--------------------------------

### Response: Historic data grouped by month

Source: https://www.wappalyzer.com/docs/api/v2/lookup

Example response for historic data, showing monthly grouped technology results.

```json
[
  {
    "url": "https://example.com",
    "results": [
      {
        "monthYear": "01-2020", // The month in which the technologies were identified
        "technologies": [
          {
            "slug": "craft-cms",
            "name": "Craft CMS",
            "cpe": "cpe:2.3:a:craftcms:craft_cms:*:*:*:*:*:*:*:*",
            "categories": [
              {
                "id": 1,
                "slug": "cms",
                "name": "CMS"
            ],
            "versions": [
              "3.0.0"
            ],
            "trafficRank": 1000
            "confirmedAt": 1612824037,
          }
        ]
      },
      {
        "monthYear": "02-2020",
        "technologies": [
          ...
        ]
      }
    ]
  }
]
```

--------------------------------

### GET /v2/lookup/ (Live results with callback - deep scan)

Source: https://www.wappalyzer.com/docs/api/v2/lookup

This method provides the most up-to-date results. A deep scan is performed on every URL and results are sent to your callback URL within minutes. Costs 5 credits per request.

```APIDOC
## [GET] /v2/lookup/

### Description
This method provides the most up-to-date results. A deep scan is performed on every URL and results are sent to your callback URL within minutes. Costs 5 credits per request.

### Method
GET

### Endpoint
https://api.wappalyzer.com/v2/lookup/

### Parameters
#### Query Parameters
- **urls** (string) - Required - Comma-separated list of URLs to look up.
- **live** (boolean) - Required - Set to `true` to perform a live deep scan.
- **callback_url** (string) - Required - Public callback URL to receive the results via POST when the crawl completes.

### Request Example
```
curl -H "x-api-key: <your api key>" "https://api.wappalyzer.com/v2/lookup/?urls=https://example.com,https://example.org&live=true&callback_url=https://yourdomain.com"
```

### Response
#### Initial Response
When `live=true`, the initial response does not return any technologies. The callback URL will receive the results in a POST request when the crawl completes (up to 15 minutes later).

#### Callback Response
- **url** (string) - The requested URL.
- **technologies** (array) - List of identified technologies. Each technology has:
  - **slug** (string) - Technology slug.
  - **name** (string) - Technology name.
  - **cpe** (string) - CPE identifier.
  - **categories** (array) - List of categories, each with id, slug, and name.
  - **versions** (array) - List of detected versions.

#### Callback Response Example
```
{
  "url": "https://example.com",
  "technologies": [
    {
      "slug": "craft-cms",
      "name": "Craft CMS",
      "cpe": "cpe:2.3:a:craftcms:craft_cms:*:*:*:*:*:*:*:*",
      "versions": [
        "3.0.0"
      ],
      "categories": [
        {
          "id": 1,
          "slug": "cms",
          "name": "CMS"
        }
      ]
    }
  ]
}
```
```

--------------------------------

### GET https://api.wappalyzer.com/v2/lookup/

Source: https://www.wappalyzer.com/docs/api/v2/lookup

Look up the technologies behind one or more websites. Returns cached results by default, or live results when the live parameter is set to true.

```APIDOC
## GET https://api.wappalyzer.com/v2/lookup/

### Description
Look up the technologies behind any website. Returns cached results from the database by default, or live results when `live=true` is used.

### Method
GET

### Endpoint
https://api.wappalyzer.com/v2/lookup/

### Parameters
#### Query Parameters
- **urls** (string) - Required - Between one and ten website URLs, comma separated. Example: `https://example.com,https://example.org`. Multiple URLs are not supported with `recursive=false`.
- **live** (boolean) - Optional - Scan websites in real-time. Defaults to `false` to return cached results. If no record is found, `live=true` is automatically used instead. Use `recursive=false` to get live results in the same request.
- **recursive** (boolean) - Optional - Index multiple pages (follows internal website links for increased coverage). Defaults to `true`. If no record is found or `live=true` is used, using `recursive=true` causes the request to be completed asynchronously. A crawl can take up to 15 minutes.
- **callback_url** (string) - Optional - When an asynchronous request completes, a POST request is made to the callback URL with the results. Required when using both `live=true` and `recursive=true`.
- **debug_email** (string) - Optional - Send debug information to the specified email address when using `callback_url`. Example: `john@example.com`. For testing purposes only.
- **sets** (string) - Optional - Comma-separated list of additional field sets to include in the results (e.g. `meta,social`). Use `all` to include all fields.
- **denoise** (boolean) - Optional - Exclude low confidence results. Defaults to `true`. Setting to `false` yields more results but may include false positives.
- **min_age** (integer) - Optional - Return results that have been verified at least once before `min_age` months ago. Defaults to `0`. Use with `squash=false` and `max_age` for historic results grouped by month.
- **max_age** (integer) - Optional - Return results that have been verified at least once in the last `max_age` months. Defaults to `2`. Use higher values for more but less recently verified results.
- **squash** (boolean) - Optional - Merge monthly results into a single set. Defaults to `true`. Set to `false` to group results by month.

### Response
#### Success Response (200)
The response includes technologies detected, and optionally company details, verified email addresses, phone numbers, social media profiles, locale information, keywords, metadata, and more depending on the `sets` parameter.

#### Response Example
(No explicit response example provided in the source.)

```

--------------------------------

### List all lists: cURL request and response

Source: https://www.wappalyzer.com/docs/api/v2/lists

Sends the GET request to list all lead lists and shows the JSON response body. The response includes list properties such as id, createdAt, status, totalCredits, technologies, keywords, and rows.

```bash
curl -H "x-api-key: <your api key>" "https://api.wappalyzer.com/v2/lists/"
```

```json
[
  {
    "id": "lst_abcdef",
    "createdAt": 1620687647,
    "status": "Ready",
    "totalCredits": 1000,
    "technologies": [
      {
        "slug": "shopify",
        "name": "Shopify",
        "categories": [
          {
            "slug": "ecommerce",
            "name": "Ecommerce"
          }
        ],
        "operator": "=",
        "version": null
      },
    ],
    "keywords": [],
    "rows": 1000
  }
]
```

--------------------------------

### Create list with callback

Source: https://www.wappalyzer.com/docs/api/v2/lists

Create a list with a callback URL. The first response shows the list ID and status 'Calculating'; the callback response is sent when the list is ready and includes totalCredits needed for finalization.

```bash
curl -X POST -H "Content-Type: application/json" -H "x-api-key: <your api key>" "https://api.wappalyzer.com/v2/lists/" -d '{ "technologies": [ { "slug": "shopify" } ] }'
```

```json
{
  "id": "lst_abcdef",
  "status": "Calculating"
}
```

```json
{
  "id": "lst_abcdef",
  "status": "Ready",
  "rows": {
    "shopify": 1000
  },
  "setRows": {
    "email": 1000
  },
  "totalCredits": 1000,
  "sampleUrl": "https://lists.wappalyzer.com/wappalyzer-29ddddaa-4949-4217-86a7-f6a407e5853d-lst_abcdef-5ukjhs-sample.zip"
}
```

--------------------------------

### cURL request to get subdomains

Source: https://www.wappalyzer.com/docs/api/v2/subdomains

Sends a GET request to the subdomains endpoint with an API key and a domain parameter. Requires a Business plan and an API key.

```bash
curl -H "x-api-key: <your api key>" "https://api.wappalyzer.com/v2/subdomains/?domains=example.com"
```

--------------------------------

### cURL: Historic data lookup with squash=false and max_age=12

Source: https://www.wappalyzer.com/docs/api/v2/lookup

cURL request using squash=false to get results grouped by month, and max_age=12 to get up to a year's worth of historical data.

```bash
curl -H "x-api-key: <your api key>" "https://api.wappalyzer.com/v2/lookup/?urls=https://example.com&callback_url=https://yourdomain.com&squash=false&max_age=12"
```

--------------------------------

### GET https://api.wappalyzer.com/v2/credits/balance/

Source: https://www.wappalyzer.com/docs

Retrieves the current API credit balance for the authenticated account.

```APIDOC
## [GET] https://api.wappalyzer.com/v2/credits/balance/

### Description
Retrieve the current credit balance for the authenticated API key.

### Method
GET

### Endpoint
https://api.wappalyzer.com/v2/credits/balance/

### Authentication
Requires an API key sent in the `x-api-key` header.

### Request Example
```
curl -H "x-api-key: <your api key>" "https://api.wappalyzer.com/v2/credits/balance/"
```

### Response
#### Success Response (200)
Returns a JSON object with the credit balance.

#### Response Example
```
{
  "credits": 100000
}
```
```

--------------------------------

### Fetch a list with cURL and get its response

Source: https://www.wappalyzer.com/docs/api/v2/lists

A cURL command fetches the full details of a list by its ID using the v2 endpoint. The response body shows the list properties such as status, technologies, filters, and download URLs. Use the request to retrieve a list once it is ready; the response includes both the list data and metadata like pricing and sample URL.

```cURL
curl -H "x-api-key: <your api key>" "https://api.wappalyzer.com/v2/lists/lst_abcdef"
```

```JSON
{
  "id": "lst_abcdef",
  "createdAt": 1620687647,
  "status": "Ready",
  "technologies": [
    {
      "slug": "shopify",
      "name": "Shopify",
      "categories": [
        {
          "slug": "ecommerce",
          "name": "Ecommerce"
        }
      ],
      "operator": "=",
      "version": null
    },
  ],
  "keywords": [ "FASHION" ],
  "languages": [ "en-us" ],
  "countries": [ "US" ],
  "industries": [ "Fashion & Apparel" ],
  "companySizes": [ "1,001-5,000 employees" ],
  "tlds": [ ".com" ],
  "matchCountryLanguage": false,
  "matchTechnologies": "or",
  "rootPath": false,
  "subset": 1000,
  "subsetSlice": 0,
  "subdomains": "include",
  "minAge": 0,
  "maxAge": 3,
  "fromDate": null,
  "requiredSets": [ "email" ],
  "excludeNoTraffic": false,
  "excludeMultilingual": false,
  "sets": [
    "email",
  ],
  "callbackUrl": "https://yourdomain/wappalyzer",
  "format": "csv",
  "totalCredits": 1000,
  "url": null,
  "sampleUrl": "https://lists.wappalyzer.com/wappalyzer-29ddddaa-4949-4217-86a7-f6a407e5853d-lst_abcdef-5ukjhs-sample.zip",
  "rows": {
    "shopify": 1000
  },
  "setRows": {
    "email": 1000,
  },
  "baseListId": "lst_abcdef"
}
```

--------------------------------

### POST /v2/lists/

Source: https://www.wappalyzer.com/docs/api/v2/lists

Creates a new list generation request. The response includes a list ID and status. A callback URL will receive a POST request when the list is ready.

```APIDOC
## POST /v2/lists/

### Description
Creates a new list generation request. The response includes a list ID and status. A callback URL will receive a POST request when the list is ready.

### Method
POST

### Endpoint
https://api.wappalyzer.com/v2/lists/

### Parameters
#### Request Body
- **technologies** (array) - Required - List of technologies to include in the list. Each item has a `slug` property.

### Request Example
```
curl -X POST -H "Content-Type: application/json" -H "x-api-key: <your api key>" "https://api.wappalyzer.com/v2/lists/" -d '{ "technologies": [ { "slug": "shopify" } ] }'
```

### Response
#### Success Response (200)
- **id** (string) - The list's unique identifier.
- **status** (string) - The current status of the list (e.g., "Calculating").

#### Response Example
```
{
  "id": "lst_abcdef",
  "status": "Calculating"
}
```

### Callback Response
When the list is ready, a POST request is sent to your callback URL with the following body:
```
{
  "id": "lst_abcdef",
  "status": "Ready",
  "rows": {
    "shopify": 1000
  },
  "setRows": {
    "email": 1000
  },
  "totalCredits": 1000,
  "sampleUrl": "https://lists.wappalyzer.com/wappalyzer-29ddddaa-4949-4217-86a7-f6a407e5853d-lst_abcdef-5ukjhs-sample.zip"
}
```
```

--------------------------------

### Add Wappalyzer MCP server via Codex CLI

Source: https://www.wappalyzer.com/docs/integrations/mcp

Use these commands to add the Wappalyzer MCP server to Codex and log in. After signing in, you can ask Codex to perform site lookups, subdomain lookups, or credit-balance checks.

```bash
codex mcp add wappalyzer --url https://mcp.wappalyzer.com/mcp
codex mcp login wappalyzer
```

--------------------------------

### POST /v2/lists

Source: https://www.wappalyzer.com/docs/api/v2/lists

Creates a new lead list based on provided filters. The request is asynchronous and returns a list ID and status. Detailed results are available via callback or when fetching the list later.

```APIDOC
## POST /v2/lists

### Description
Creates a new lead list from technologies, keywords, and company filters. Use this endpoint to turn your ICP criteria into a downloadable prospect set.

### Method
POST

### Endpoint
`https://api.wappalyzer.com/v2/lists`

### Properties
- Execution: Asynchronous
- Request timeout: 20 seconds
- Rate limit: 10 requests per second, 25 requests per day, 3 concurrent requests (lists with `Calculating` status)
- Pricing: Free

### Parameters
#### Request Body
- `technologies` (array) - Optional - Array of technologies to filter by (no more than 50). Each technology object has:
  - `slug` (string, required) - Technology slug, e.g. `hubspot-chat`. Refer to the full list of technologies (JSON).
  - `version` (string, optional) - Optional version number to target, e.g. `1.0.0`.
  - `operator` (string, optional) - Version number operator, one of `=` (exact match), `>=` (greater than or equal to) or `<=` (lower than or equal to).
- `categories` (array) - Optional - Array of category slugs to filter by (e.g. `payment-processors`). Refer to the full list of categories (JSON). If a category includes more than 50 technologies, only the top 50 technologies will be selected.
- `keywords` (array) - Optional - Array of keywords to filter by, e.g. `fashion`. Keywords must be alphanumeric (`a-z0-9`) and work best with English nouns. Prefix with `not ` to exclude, e.g. `not fashion`.
- `languages` (array) - Optional - Array of language codes (ISO 639-1) to filter, e.g. `en-us`.
- `countries` (array) - Optional - Array of two-letter country codes (ISO 3166-2) to filter, e.g. `US`.
- `industries` (array) - Optional - Array of industries, e.g. `Fashion & Apparel`. List of industries.
- `companySizes` (array) - Optional - Array of company sizes to filter, e.g. `5000` for 1,001-5,000 employees. List of company sizes.
- `tlds` (array) - Optional - Array of top-level domains to filter, e.g. `.com`.
- `matchCountryLanguage` (boolean) - Optional - Filter by both country and language (`true`) or either (`false`).
- `matchTechnologies` (string) - Optional - Operator for the technology filter, one of `or` (match any), `and` (match all) or `not` (match the first technology, exclude all others).
- `rootPath` (boolean) - Optional - Only include websites that have the selected technology on the root path (typically the homepage).
- `subset` (number) - Optional - Limit the number of results in the list per technology. Use `subsetSlice` to target high or low traffic websites.
- `subsetSlice` (number) - Optional - Websites in the list are sorted in order of traffic. When a `subset` is specified, `subsetSlice` determines which section of the list the results should be taken from (i.e. top or bottom). Set to `0`-`4` for highest, high, medium, low and lowest traffic, respectively. Default is `0` for highest traffic. This option has no effect when `subset` is equal to or larger than the total number of available results.
- `minAge` (number) - Optional - Include results that were verified at least `minAge` months ago (`0`-`11`, default is `0`).
- `maxAge` (number) - Optional - Include results that were verified at most `maxAge` months ago (`1`-`12`, default is `3`).
- `fromDate` (number) - Optional - Only include websites that were discovered after a date (UNIX timestamp, e.g. `1620687647`).
- `requiredSets` (array) - Optional - Array of required field sets, e.g. `email`. See Fields.
- `subdomains` (string) - Optional - Include or exclude subdomain in the results. One of `include` (default), `exclude` or `merge`. By selecting `merge`, data for subdomains (such as languages and traffic) on a domain will be combined into a single result.
- `excludeNoTraffic` (boolean) - Optional - Exclude websites that don't include traffic data (`true` or `false` (default)).
- `excludeMultilingual` (boolean) - Optional - Exclude websites with content in more than one language (`true` or `false` (default)).
- `excludeListId` (string) - Optional - ID of a list to use for exclusions, e.g. `lst_abcdef`. Any URLs that appear in this list will be excluded from the new list. This function is recursive, i.e. if an excluded list excludes another list, both are excluded. Limited to ten lists or 500,000 websites.
- `baseListId` (string) - Optional - ID of a list to use as a base, e.g. `lst_abcdef`. The results will be filtered to only include websites that are also in the base list.
- `sets` (array) - Optional - Array of field sets to include in the results, e.g. `email`. See Fields.
- `callbackUrl` (string) - Optional - Callback URL that's notified when the list is ready, e.g. `https://yourdomain.com/wappalyzer`.
- `format` (string) - Optional - Output file format, one of `csv` (default) or `json`.

### Request Example
```json
{
  "technologies": [
    {
      "slug": "hubspot-chat",
      "version": "1.0.0",
      "operator": ">="
    }
  ],
  "categories": ["payment-processors"],
  "keywords": ["fashion"],
  "languages": ["en-us"],
  "countries": ["US"],
  "industries": ["Fashion & Apparel"],
  "companySizes": [5000],
  "tlds": [".com"],
  "matchCountryLanguage": true,
  "matchTechnologies": "or",
  "rootPath": true,
  "subset": 100,
  "subsetSlice": 0,
  "minAge": 0,
  "maxAge": 3,
  "fromDate": 1620687647,
  "requiredSets": ["email"],
  "subdomains": "include",
  "excludeNoTraffic": false,
  "excludeMultilingual": false,
  "excludeListId": "lst_abcdef",
  "baseListId": "lst_abcdef",
  "sets": ["email"],
  "callbackUrl": "https://yourdomain.com/wappalyzer",
  "format": "csv"
}
```

### Response
#### Success Response (200)
The initial response only includes the list ID and current status. Detailed fields such as `totalCredits`, `sampleUrl`, `rows` and `setRows` become available through the callback payload below or when fetching the list later.
- `id` (string) - The list's unique identifier.
- `status` (string) - List status. One of `Calculating`, `Ready`, `Failed`, `Insufficient` or `Complete`.

#### Response Example
```json
{
  "id": "lst_abcdef",
  "status": "Calculating"
}
```
```
Tokens:
Raw