Snov.io

Snov.io Domain Search API

Search for company information and email addresses by domain

GitHub OpenAPI

Operations 9

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

POST /v2/domain-search/start Start a company domain search · Start domain search #
Ask an LLM
“How do I look up what Snov.io knows about a company domain?”
“How many credits does a domain search cost?”
Tell an agent
Start a domain search for {domain}.
Kick off a company lookup on domain {domain}.
GET /v2/domain-search/result/{task_hash} Get company domain search results · Get domain search results #
Ask an LLM
“Where do I get the results of a domain search I already started?”
“Is my company domain lookup finished yet?”
Tell an agent
Get domain search results for task {task_hash}.
Fetch the company lookup result for task {task_hash}.
POST /v2/domain-search/prospects/start Find prospects at a company domain · Start domain prospect search #
Ask an LLM
“Can I find people who work at a company by its domain?”
“Is it possible to filter a company's prospects by job title?”
Tell an agent
Find prospects at {domain}.
Search {domain} for prospects in positions {positions}, page {page}.
GET /v2/domain-search/prospects/result/{task_hash} Get domain prospect search results · Get domain prospect search results #
Ask an LLM
“Where do I collect the prospect profiles from a domain prospect search?”
“Has my search for people at a company finished?”
Tell an agent
Get prospect search results for task {task_hash}.
Fetch the people found by domain prospect task {task_hash}.
POST /v2/domain-search/domain-emails/start Find all email addresses at a domain · Start domain emails search #
Ask an LLM
“Can I get every email address associated with a company domain?”
“What's the way to collect all known emails for a website?”
Tell an agent
Find all email addresses at {domain}.
Start a domain emails search for {domain}.
GET /v2/domain-search/domain-emails/result/{task_hash} Get domain email addresses search results · Get domain emails search results #
Ask an LLM
“Where are the email addresses from my domain emails search?”
“Is the list of emails for a domain ready to download?”
Tell an agent
Get domain emails results for task {task_hash}.
Fetch the email addresses found by task {task_hash}.
POST /v2/domain-search/generic-contacts/start Find generic contact addresses at a domain · Start generic contacts search #
Ask an LLM
“Can I find a company's info@ or support@ style addresses?”
“How do I look up generic role mailboxes for a domain?”
Tell an agent
Find generic contact addresses like info@ for {domain}.
Start a generic contacts search on {domain}.
GET /v2/domain-search/generic-contacts/result/{task_hash} Get generic contacts search results · Get generic contacts search results #
Ask an LLM
“Where do I get the info@ and support@ addresses my search found?”
“Are the generic company mailboxes ready for my lookup?”
Tell an agent
Get generic contacts results for task {task_hash}.
Fetch the role mailboxes found by task {task_hash}.
POST /v1/get-domain-emails-count Count available emails for a domain · Check available emails count (free) #
Ask an LLM
“Can I check how many email addresses exist for a domain without spending credits?”
“How many emails are available for a company before I run a paid search?”
Tell an agent
Count available email addresses for {domain}.
Check for free how many emails Snov.io has for {domain}.

Documentation

📖
Documentation
https://snov.io/api

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/snov-io/refs/heads/main/openapi/snov-io-domain-search-api-openapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/snov-io/refs/heads/main/overlays/snov-io-domain-search-api-overlay.yaml
🔗
GraphQL
https://raw.githubusercontent.com/api-evangelist/snov-io/refs/heads/main/graphql/snov-io-graphql.md

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/snov-io:snov-io-domain-search-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

snov-io-domain-search-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Snov.io Domain Search API
  description: Snov.io is a sales automation and lead generation platform. The REST API enables programmatic access to email finding, domain search, email verification, drip campaign management, email warm-up, prospect management, CRM pipeline, and webhook subscriptions. Authentication uses OAuth 2.0 client credentials to obtain short-lived Bearer tokens. All API operations consume credits from the account balance.
  version: '2.0'
  contact:
    name: Snov.io Support
    url: https://snov.io/knowledgebase/
  termsOfService: https://snov.io/terms-of-service/
  license:
    name: Proprietary
    url: https://snov.io/terms-of-service/
servers:
- url: https://api.snov.io
  description: Snov.io API server
tags:
- name: Domain Search
  description: Search for company information and email addresses by domain
paths:
  /v2/domain-search/start:
    post:
      tags:
      - Domain Search
      summary: Start domain search
      description: Initiate an async domain search. Returns a task_hash to retrieve results. Costs 1 credit per unique domain request.
      operationId: startDomainSearch
      security:
      - bearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - domain
              properties:
                domain:
                  type: string
                  description: Company domain name to search
                  example: example.com
      responses:
        '200':
          description: Task started
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskStarted'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /v2/domain-search/result/{task_hash}:
    get:
      tags:
      - Domain Search
      summary: Get domain search results
      description: Retrieve results of a previously started domain search task.
      operationId: getDomainSearchResult
      security:
      - bearerAuth: []
      parameters:
      - $ref: '#/components/parameters/TaskHash'
      responses:
        '200':
          description: Domain search results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DomainSearchResult'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
  /v2/domain-search/prospects/start:
    post:
      tags:
      - Domain Search
      summary: Start domain prospect search
      description: Initiate an async search for prospect profiles associated with a domain.
      operationId: startDomainProspectSearch
      security:
      - bearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - domain
              properties:
                domain:
                  type: string
                  example: example.com
                positions:
                  type: array
                  items:
                    type: string
                  description: Filter by job positions
                  example:
                  - CEO
                  - CTO
                page:
                  type: integer
                  description: Page number for pagination
                  default: 1
      responses:
        '200':
          description: Task started
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskStarted'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /v2/domain-search/prospects/result/{task_hash}:
    get:
      tags:
      - Domain Search
      summary: Get domain prospect search results
      operationId: getDomainProspectSearchResult
      security:
      - bearerAuth: []
      parameters:
      - $ref: '#/components/parameters/TaskHash'
      responses:
        '200':
          description: Prospect search results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProspectListResult'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /v2/domain-search/domain-emails/start:
    post:
      tags:
      - Domain Search
      summary: Start domain emails search
      description: Initiate an async search for all email addresses associated with a domain.
      operationId: startDomainEmailsSearch
      security:
      - bearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - domain
              properties:
                domain:
                  type: string
                  example: example.com
      responses:
        '200':
          description: Task started
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskStarted'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /v2/domain-search/domain-emails/result/{task_hash}:
    get:
      tags:
      - Domain Search
      summary: Get domain emails search results
      operationId: getDomainEmailsSearchResult
      security:
      - bearerAuth: []
      parameters:
      - $ref: '#/components/parameters/TaskHash'
      responses:
        '200':
          description: Domain emails results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmailListResult'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /v2/domain-search/generic-contacts/start:
    post:
      tags:
      - Domain Search
      summary: Start generic contacts search
      description: Initiate an async search for generic company contact addresses (e.g. info@, support@).
      operationId: startGenericContactsSearch
      security:
      - bearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - domain
              properties:
                domain:
                  type: string
                  example: example.com
      responses:
        '200':
          description: Task started
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskStarted'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /v2/domain-search/generic-contacts/result/{task_hash}:
    get:
      tags:
      - Domain Search
      summary: Get generic contacts search results
      operationId: getGenericContactsSearchResult
      security:
      - bearerAuth: []
      parameters:
      - $ref: '#/components/parameters/TaskHash'
      responses:
        '200':
          description: Generic contacts results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmailListResult'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /v1/get-domain-emails-count:
    post:
      tags:
      - Domain Search
      summary: Check available emails count (free)
      description: Returns the count of available email addresses for a domain. Free endpoint.
      operationId: getDomainEmailsCount
      security:
      - bearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - domain
              properties:
                domain:
                  type: string
                  example: example.com
      responses:
        '200':
          description: Email count for domain
          content:
            application/json:
              schema:
                type: object
                properties:
                  domain:
                    type: string
                  result:
                    type: integer
                    description: Number of available emails
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  responses:
    Unauthorized:
      description: Unauthorized — missing or invalid Bearer token
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    ProspectProfile:
      type: object
      properties:
        id:
          type: string
        first_name:
          type: string
        last_name:
          type: string
        email:
          type: string
          format: email
        position:
          type: string
        company:
          type: string
        location:
          type: string
        industry:
          type: string
        social:
          type: object
          properties:
            linkedin:
              type: string
              format: uri
            twitter:
              type: string
              format: uri
        job_history:
          type: array
          items:
            type: object
            properties:
              title:
                type: string
              company:
                type: string
              start_date:
                type: string
              end_date:
                type: string
    ProspectListResult:
      type: object
      properties:
        status:
          type: string
        data:
          type: array
          items:
            $ref: '#/components/schemas/ProspectProfile'
    TaskStarted:
      type: object
      properties:
        task_hash:
          type: string
          description: Unique identifier for the async task; use to poll for results
        status:
          type: string
          description: Current task status
    DomainSearchResult:
      type: object
      properties:
        status:
          type: string
        data:
          type: object
          properties:
            domain:
              type: string
            company_name:
              type: string
            industry:
              type: string
            size:
              type: string
            prospect_count:
              type: integer
            email_count:
              type: integer
            related_domains:
              type: array
              items:
                type: string
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error code
        message:
          type: string
          description: Human-readable error message
    EmailListResult:
      type: object
      properties:
        status:
          type: string
        data:
          type: array
          items:
            type: object
            properties:
              email:
                type: string
                format: email
              first_name:
                type: string
              last_name:
                type: string
              position:
                type: string
              confidence:
                type: integer
  parameters:
    TaskHash:
      name: task_hash
      in: path
      required: true
      schema:
        type: string
      description: Task hash returned from the corresponding start endpoint
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Obtain a Bearer token via POST /v1/oauth/access_token using client credentials. Tokens expire after 3600 seconds.