Skip to main content

A Python wrapper around Snov.io API

Project description

Python-Snovio

Python library for interacting with the snov.io API

This is being developed to make it easier for Python users to interact with the API. It is just a light wrapper around the official API.

All features should be supported with the exception of those that are related to lists. In any case, feel free to add features, I welcome pull requests.

Powered by Remote Crew

Remote Crew

Build Status

Installation

Python-snovio has been developed in Python 3.x. Some adjustments might be necessary to run in Python 2.x

Install the package using the following command.

$ pip install python-snovio

User Guide

Setup

Start by importing the class from the package.

from snovio import SnovioAPI

The next step is to get the credentials from the API tab of your account at Snov.io.

SNOVIO_USER_ID = 'your-user-id'
SNOVIO_USER_SECRET = 'your-user-secret' 

Finally, initialize the instance of SnovioAPI with your credentials.

snovio = SnovioAPI(client_id=SNOVIO_USER_ID, client_secret=SNOVIO_USER_SECRET)

If you'd prefer to use your access_token instead, you can also initialize the instance using it directly.

snovio = SnovioAPI(access_token=ACCESS_TOKEN)

Requests

You can now start to make requests using your account. See below the requests you can make, along with their cost in Credits.

EMAIL FINDER
  • 2 Credits: Domain Search v.2 √

    snovio.domain_emails_with_info({
        'domain':'riskpulse.com',
        'type': 'all',
        'limit': 100,
        'lastId': 0
    })
    
  • Free: Get domain emails count √

    snovio.get_domain_emails_count({
        'domain': 'riskpulse.com'
    }) 
    
  • 1 Credit: Get emails from names √

    snovio.get_emails_from_names({
       'firstName': 'Joe',
       'lastName': 'Thomas',
       'domain': 'loom.com'
    })
    
  • 1 Credit: Add names to find emails √

    snovio.add_names_to_find_emails({
       'firstName': 'Joe',
       'lastName': 'Thomas',
       'domain': 'loom.com'
    })
    
  • 1 Credit: Add URL to search for prospect √

    snovio.add_url_for_search({
       'url': 'https://www.linkedin.com/in/elie-ohayon-aaab7341'
    })
    
  • 1 Credit: Get prospect with URL √

    snovio.get_emails_from_url({
       'url': 'https://www.linkedin.com/in/elie-ohayon-aaab7341'
    })
    
  • 1 Credit: Get profile by email √

    snovio.get_profile_by_email({
       'email': 'lizi.hamer@octagon.com',
    })
    
EMAIL VERIFIER
  • FREE: Get emails verification status √

    snovio.get_emails_verification_status({
        'emails': ['gavin.vanrooyen@octagon.com', 'lizi.hamer@octagon.com']
    })
    
  • 0.5 Credits: Add emails to verification: √

    snovio.add_emails_to_verification({
       'emails': ['sales@riskpulse.com', 'lizi.hamer@octagon.com']
    })
    
DRIP CAMPAIGNS
  • Free: Change recipient’s status √

    snovio.change_recipient_status({
        'email': 'gavin.vanrooyen@octagon.com',
        'campaign_id': 1234567,
        'status': 'Active'
    })
    
  • Free: See list of completed prospects √

    snovio.prospect_finished({
        'campaignId': 1234567
    })
    
  • Free: See campaign replies √

    snovio.get_emails_replies({
        'campaignId': 1234567
    })
    
  • Free: Check link clicks √

    snovio.get_emails_clicked({
        'campaignId': 1234567
    })
    
  • Free: View sent emails √

    snovio.emails_sent({
        'campaignId': 1234567
    })
    
  • Free: View all campaigns √

    snovio.get_user_campaigns()
    
  • Free: Add to Do-not-email List √

    snovio.do_not_email_list({
        'items[]': ['gavin.vanrooyen@octagon.com', 'octagon.com']
    })
    
PROSPECT MANAGEMENT
  • Free: Add prospect to list √

    snovio.add_prospect_to_list({
        'email': 'john.doe@example.com',
        'fullName': 'John Doe',
        'firstName': 'John',
        'lastName': 'Doe',
        'country': 'United States',
        'locality': 'Woodbridge, New Jersey',
        'socialLinks[linkedIn]': 'https://www.linkedin.com/in/johndoe/&social',
        'social[twitter]': 'https://twitter.com/johndoe&social',
        'customFields[phone number]': '+ 1 888 2073333',
        'position': 'Vice President of Sales',
        'companyName': 'GoldenRule',
        'companySite': 'https://goldenrule.com',
        'updateContact': 1,
        'listId': '7508737'
    })
    
  • Free: Find prospect by ID √

    snovio.get_prospect_by_id({
        'id': '66773b4a7e7b84180d2d8ed71a6a1fc657c22b7d38cc5684053faeb15ec8f392b874f87423'
    })
    
  • Free: Find prospect by Email √

    snovio.get_prospects_by_email({
        'email': 'john.doe@example.com'
    })
    
  • Free: Find prospect’s custom fields √

    snovio.prospect_custom_fields()
    
  • Free: See user lists √

    snovio.get_user_lists()
    
  • Free: View prospects in list √

    snovio.prospect_list({
        'listId': '7508737',
        'page': 1,
        'perPage': 10
    })
    
  • Free: Create new prospects list √

    snovio.lists({
        'name': 'Test Lists',
    })
    
USER ACCOUNT
  • Free: Check user balance √
    snovio.get_balance()
    

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python-snovio-0.2.1.tar.gz (5.9 kB view details)

Uploaded Source

File details

Details for the file python-snovio-0.2.1.tar.gz.

File metadata

  • Download URL: python-snovio-0.2.1.tar.gz
  • Upload date:
  • Size: 5.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.59.0 importlib-metadata/4.5.0 keyring/21.8.0 rfc3986/1.5.0 colorama/0.4.4 CPython/3.6.10

File hashes

Hashes for python-snovio-0.2.1.tar.gz
Algorithm Hash digest
SHA256 174f32bd91f5150e957e3e0d0632563879ef9dc6d2321c1fc3bf369f29cb4888
MD5 a7cfef88d7208550882b63aa638214d0
BLAKE2b-256 58e8951faf3eb4f57da2ba8b87b908227a201c4150a4e74c6b5b6b65f7a3a967

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page