Wappalyzer

Wappalyzer Lists API

Lead list creation, pricing, and download lifecycle.

GitHub OpenAPI
Business capability
Company & Contact Data AE-230.30

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /lists List the lead lists I have created · List created lead lists #
Ask an LLM
“Which lead lists have I already created?”
“Can I see all my lead lists and their status in one place?”
Tell an agent
List all the lead lists I've created.
Show me every lead list on my account.
POST /lists Build a new lead list of websites by technology · Create a lead list #
Ask an LLM
“How do I build a list of websites that use a particular technology?”
“Can I narrow a new lead list by country, industry or company size?”
Tell an agent
Create a lead list of websites using {technologies} in {countries}.
Build a new lead list for {industries} companies of size {companySizes}.
GET /lists/{id} Fetch one lead list and its status · Fetch a lead list #
Ask an LLM
“Is my lead list ready yet?”
“How do I get the details of a single lead list by its id?”
Tell an agent
Fetch lead list {id}.
Check whether lead list {id} has finished building.
POST /lists/{id} Spend credits to finalize a ready lead list · Spend credits and finalize a ready lead list #
Ask an LLM
“How do I pay credits to unlock a lead list once it's ready?”
“What do I need to do to finalize a lead list so I can download it?”
Tell an agent destructive · confirm first
Finalize lead list {id} and spend {spendCredits} credits on it.
Spend the credits to complete ready lead list {id}, confirming with {spendCredits}.
DELETE /lists/{id} Delete a lead list · Delete a lead list #
Ask an LLM
“Can I remove a lead list I no longer need?”
“What happens if I delete one of my lead lists?”
Tell an agent destructive · confirm first
Delete lead list {id}.
Remove the lead list {id} from my account.

Documentation

📖
Documentation
https://www.wappalyzer.com/docs/api/v2/lists/

Specifications

⚙
OpenAPI
https://artifacts.apis.io/wappalyzer/openapi/wappalyzer-lists-api-openapi.yml

Other Resources

🔗
Examples
https://artifacts.apis.io/wappalyzer/examples/wappalyzer-create-list-example.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/wappalyzer:wappalyzer-lists-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

wappalyzer-lists-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Wappalyzer Public Lists API
  version: v2
  description: 'OpenAPI 3.0 contract for Wappalyzer''s documented public REST endpoints.

    Covers credit balance, technology lookup, lead lists, subdomain discovery,

    and email verification.'
  license:
    name: Proprietary
    url: https://www.wappalyzer.com/terms/
  contact:
    name: Wappalyzer Support
    url: https://www.wappalyzer.com/contact/
servers:
- url: https://api.wappalyzer.com/v2
security:
- ApiKeyAuth: []
tags:
- name: Lists
  description: Lead list creation, pricing, and download lifecycle.
paths:
  /lists:
    get:
      tags:
      - Lists
      operationId: listLeadLists
      summary: List created lead lists
      responses:
        '200':
          description: Lead lists returned successfully.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ListSummary'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
    post:
      tags:
      - Lists
      operationId: createLeadList
      summary: Create a lead list
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateListRequest'
      responses:
        '200':
          description: Lead list accepted for pricing and generation.
          headers:
            wappalyzer-credits-spent:
              $ref: '#/components/headers/CreditsSpent'
            wappalyzer-credits-remaining:
              $ref: '#/components/headers/CreditsRemaining'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateListAccepted'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
  /lists/{id}:
    get:
      tags:
      - Lists
      operationId: getLeadList
      summary: Fetch a lead list
      parameters:
      - $ref: '#/components/parameters/ListId'
      responses:
        '200':
          description: Lead list returned successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListDetail'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
    post:
      tags:
      - Lists
      operationId: finalizeLeadList
      summary: Spend credits and finalize a ready lead list
      parameters:
      - $ref: '#/components/parameters/ListId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FinalizeListRequest'
      responses:
        '200':
          description: Lead list finalized successfully.
          headers:
            wappalyzer-credits-spent:
              $ref: '#/components/headers/CreditsSpent'
            wappalyzer-credits-remaining:
              $ref: '#/components/headers/CreditsRemaining'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FinalizeListResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
    delete:
      tags:
      - Lists
      operationId: deleteLeadList
      summary: Delete a lead list
      parameters:
      - $ref: '#/components/parameters/ListId'
      responses:
        '200':
          description: Lead list deleted successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmptyObject'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
components:
  schemas:
    CreateListAccepted:
      type: object
      required:
      - id
      - status
      properties:
        id:
          type: string
          pattern: ^lst_
        status:
          type: string
          enum:
          - Calculating
    ListSummary:
      type: object
      required:
      - id
      - status
      properties:
        id:
          type: string
          pattern: ^lst_
        createdAt:
          type: integer
        status:
          $ref: '#/components/schemas/ListStatus'
        totalCredits:
          type: integer
        technologies:
          type: array
          items:
            $ref: '#/components/schemas/ListTechnology'
        keywords:
          type: array
          items:
            type: string
        rows:
          type: integer
    Category:
      type: object
      required:
      - slug
      - name
      properties:
        id:
          type: integer
        slug:
          type: string
        name:
          type: string
    CreateListRequest:
      type: object
      properties:
        categories:
          type: array
          items:
            type: string
        technologies:
          type: array
          items:
            type: object
            required:
            - slug
            properties:
              slug:
                type: string
              operator:
                type: string
                pattern: ^[<>]?=$
              version:
                type: string
        keywords:
          type: array
          items:
            type: string
        languages:
          type: array
          items:
            type: string
        countries:
          type: array
          items:
            type: string
        industries:
          type: array
          items:
            type: string
        companySizes:
          type: array
          items:
            type: integer
        tlds:
          type: array
          items:
            type: string
        matchCountryLanguage:
          type: boolean
        matchTechnologies:
          type: string
          enum:
          - or
          - and
          - not
        subset:
          type: integer
        subsetSlice:
          type: integer
          minimum: 0
          maximum: 4
        minAge:
          type: integer
          minimum: 0
          maximum: 11
        maxAge:
          type: integer
          minimum: 1
          maximum: 12
        fromDate:
          type: integer
        requiredSets:
          type: array
          items:
            type: string
        excludeNoTraffic:
          type: boolean
        excludeMultilingual:
          type: boolean
        sets:
          type: array
          description: Result field sets to include in the exported rows.
          items:
            type: string
        callbackUrl:
          type: string
          format: uri
        format:
          type: string
          enum:
          - json
          - csv
        baseListId:
          type: string
          pattern: ^lst_
        excludeListId:
          type: string
          pattern: ^lst_
        rootPath:
          type: boolean
        subdomains:
          type: string
          enum:
          - include
          - exclude
          - merge
    FinalizeListResponse:
      type: object
      required:
      - id
      - status
      properties:
        id:
          type: string
          pattern: ^lst_
        status:
          type: string
          enum:
          - Complete
        url:
          type: string
          format: uri
    ListStatus:
      type: string
      enum:
      - Calculating
      - Ready
      - Failed
      - Insufficient
      - Complete
    EmptyObject:
      type: object
    ListTechnology:
      type: object
      properties:
        slug:
          type: string
        name:
          type: string
        operator:
          type: string
          pattern: ^[<>]?=$
        version:
          type:
          - string
          - 'null'
        categories:
          type: array
          items:
            $ref: '#/components/schemas/Category'
    FinalizeListRequest:
      type: object
      required:
      - spendCredits
      properties:
        spendCredits:
          type: integer
    ListDetail:
      type: object
      required:
      - id
      - status
      properties:
        id:
          type: string
          pattern: ^lst_
        createdAt:
          type: integer
        status:
          $ref: '#/components/schemas/ListStatus'
        technologies:
          type: array
          items:
            $ref: '#/components/schemas/ListTechnology'
        keywords:
          type: array
          items:
            type: string
        languages:
          type: array
          items:
            type: string
        countries:
          type: array
          items:
            type: string
        industries:
          type: array
          items:
            type: string
        companySizes:
          type: array
          items:
            type: integer
        tlds:
          type: array
          items:
            type: string
        matchCountryLanguage:
          type: boolean
        matchTechnologies:
          type: string
          enum:
          - or
          - and
          - not
        subset:
          type: integer
        subsetSlice:
          type: integer
        minAge:
          type: integer
        maxAge:
          type: integer
        fromDate:
          type:
          - integer
          - 'null'
        requiredSets:
          type: array
          items:
            type: string
        excludeNoTraffic:
          type: boolean
        excludeMultilingual:
          type: boolean
        sets:
          type: array
          items:
            type: string
        callbackUrl:
          type:
          - string
          - 'null'
          format: uri
        totalCredits:
          type: integer
        url:
          type:
          - string
          - 'null'
          format: uri
        sampleUrl:
          type: string
          format: uri
        rows:
          type: object
          additionalProperties:
            type: integer
        setRows:
          type: object
          additionalProperties:
            type: integer
  headers:
    CreditsSpent:
      description: Number of credits deducted by the request.
      schema:
        type: integer
    CreditsRemaining:
      description: Remaining credit balance after the request completes.
      schema:
        type: integer
  responses:
    BadRequest:
      description: The request payload or query string was invalid.
    Forbidden:
      description: Authorization failed, the resource or method is invalid, or the account lacks sufficient credits.
    TooManyRequests:
      description: Rate limit exceeded.
  parameters:
    ListId:
      name: id
      in: path
      required: true
      description: Unique list identifier.
      schema:
        type: string
        pattern: ^lst_
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
x-provenance:
  method: harvested
  publisher: Wappalyzer
  source: https://www.wappalyzer.com/openapi/v2-public.yaml
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)