Snov.io

Snov.io Email Finder API

Find email addresses by name, LinkedIn, or domain

GitHub OpenAPI

Operations 7

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/emails-by-domain-by-name/start Find emails from a person's name and domain · Start find emails by name and domain #
Ask an LLM
“Can I find someone's email if I know their name and company domain?”
“How many credits does finding an email by name cost?”
Tell an agent
Find emails for these name and domain rows: {rows}.
Look up emails for {rows} and post results to {webhook_url}.
GET /v2/emails-by-domain-by-name/result Get find-emails-by-name results · Get find emails by name results #
Ask an LLM
“Where do I pick up the emails found from names and domains?”
“Is my name-to-email lookup finished?”
Tell an agent
Get the name-to-email results for task {task_hash}.
Fetch emails found by name lookup task {task_hash}.
POST /v2/company-domain-by-name/start Find company domains from company names · Start find domain by company name #
Ask an LLM
“I only have company names — can I find their website domains?”
“What does it cost to look up a domain from a company name?”
Tell an agent
Find domains for companies {names}.
Look up website domains for {names} and notify {webhook_url}.
GET /v2/company-domain-by-name/result Get company-name-to-domain results · Get find domain by company name results #
Ask an LLM
“Where do I get the domains found for my company names?”
“Has my company domain lookup by name completed?”
Tell an agent
Get company domain results for task {task_hash}.
Fetch the domains found by company-name task {task_hash}.
POST /v2/li-profiles-by-urls/start Enrich LinkedIn profiles by URL · Start LinkedIn profile enrichment #
Ask an LLM
“Can I get contact details from a list of LinkedIn profile URLs?”
“How many credits does LinkedIn profile enrichment use?”
Tell an agent
Enrich LinkedIn profiles {urls}.
Enrich LinkedIn URLs {urls} and send results to {webhook_url}.
GET /v2/li-profiles-by-urls/result Get LinkedIn profile enrichment results · Get LinkedIn profile enrichment results #
Ask an LLM
“Where are the enriched LinkedIn profiles I requested?”
“Is my LinkedIn URL enrichment task done?”
Tell an agent
Get LinkedIn enrichment results for task {task_hash}.
Fetch enriched LinkedIn profiles for task {task_hash}.
POST /v1/get-profile-by-email Enrich a person's profile from an email · Enrich profile by email #
Ask an LLM
“Can I find out who's behind an email address — name, job, company?”
“Am I charged a credit if no profile is found for an email?”
Tell an agent
Get the profile for {email}.
Enrich prospect details from email address {email}.

Documentation

📖
Documentation
https://snov.io/api

Specifications

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

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/snov-io/refs/heads/main/overlays/snov-io-email-finder-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-email-finder-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-email-finder-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Snov.io Email Finder 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: Email Finder
  description: Find email addresses by name, LinkedIn, or domain
paths:
  /v2/emails-by-domain-by-name/start:
    post:
      tags:
      - Email Finder
      summary: Start find emails by name and domain
      description: Find email addresses by providing first name, last name, and domain. Costs 1 credit per valid or unknown email found.
      operationId: startFindEmailsByName
      security:
      - bearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - rows
              properties:
                rows:
                  type: array
                  description: Array of name+domain rows to look up
                  items:
                    type: object
                    required:
                    - first_name
                    - last_name
                    - domain
                    properties:
                      first_name:
                        type: string
                        example: John
                      last_name:
                        type: string
                        example: Doe
                      domain:
                        type: string
                        example: example.com
                webhook_url:
                  type: string
                  format: uri
                  description: Optional webhook URL to receive results when ready
      responses:
        '200':
          description: Task started
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskStarted'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /v2/emails-by-domain-by-name/result:
    get:
      tags:
      - Email Finder
      summary: Get find emails by name results
      operationId: getFindEmailsByNameResult
      security:
      - bearerAuth: []
      parameters:
      - name: task_hash
        in: query
        required: true
        schema:
          type: string
        description: Task hash returned from the start endpoint
      responses:
        '200':
          description: Email finder results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmailFinderResult'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /v2/company-domain-by-name/start:
    post:
      tags:
      - Email Finder
      summary: Start find domain by company name
      description: Find company domains by company name. Costs 1 credit per domain found.
      operationId: startFindDomainByCompanyName
      security:
      - bearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - names
              properties:
                names:
                  type: array
                  items:
                    type: string
                  description: List of company names to look up
                  example:
                  - Acme Corp
                  - Example Inc
                webhook_url:
                  type: string
                  format: uri
      responses:
        '200':
          description: Task started
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskStarted'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /v2/company-domain-by-name/result:
    get:
      tags:
      - Email Finder
      summary: Get find domain by company name results
      operationId: getFindDomainByCompanyNameResult
      security:
      - bearerAuth: []
      parameters:
      - name: task_hash
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Company domain lookup results
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                        domain:
                          type: string
        '401':
          $ref: '#/components/responses/Unauthorized'
  /v2/li-profiles-by-urls/start:
    post:
      tags:
      - Email Finder
      summary: Start LinkedIn profile enrichment
      description: Enrich LinkedIn profiles by URL. Costs 1 credit per profile retrieved.
      operationId: startLinkedInProfileEnrichment
      security:
      - bearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - urls
              properties:
                urls:
                  type: array
                  items:
                    type: string
                    format: uri
                  description: LinkedIn profile URLs
                  example:
                  - https://www.linkedin.com/in/johndoe
                webhook_url:
                  type: string
                  format: uri
      responses:
        '200':
          description: Task started
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskStarted'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /v2/li-profiles-by-urls/result:
    get:
      tags:
      - Email Finder
      summary: Get LinkedIn profile enrichment results
      operationId: getLinkedInProfileEnrichmentResult
      security:
      - bearerAuth: []
      parameters:
      - name: task_hash
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: LinkedIn profile enrichment results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProspectListResult'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /v1/get-profile-by-email:
    post:
      tags:
      - Email Finder
      summary: Enrich profile by email
      description: Retrieve prospect profile information by email address. Costs 1 credit per request; free if no results are found.
      operationId: getProfileByEmail
      security:
      - bearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - email
              properties:
                email:
                  type: string
                  format: email
                  example: john.doe@example.com
      responses:
        '200':
          description: Prospect profile data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProspectProfile'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    EmailFinderResult:
      type: object
      properties:
        status:
          type: string
        data:
          type: array
          items:
            type: object
            properties:
              first_name:
                type: string
              last_name:
                type: string
              domain:
                type: string
              email:
                type: string
                format: email
              confidence:
                type: integer
                description: Confidence score 0-100
              status:
                type: string
                description: Email status (valid/unknown/not_valid)
    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
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error code
        message:
          type: string
          description: Human-readable error message
  responses:
    Unauthorized:
      description: Unauthorized — missing or invalid Bearer token
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  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.