Skip to main content

Library for interacting with Fullcontact's APIs.

Project description

A Python module for the Fullcontact API version 2.0 It has functionality for name stats API and person APIs(except vcard format).


You can find full documentation at

Specifically: Name API docs Person API docs

You will need a fullcontact API key to use this module. The name API is free, the person is not.

I have the name API and person API in separate classes to keep free/paid separate.


With pip (prefered)

pip install fullcontacter

With easy_install

easy_install fullcontacter

Usage Examples

import fullcontacter

def main():
    # create a name object
    fc_name = fullcontacter.nameStats('YOUR API KEY HERE')

    # create a person object
    fc_person = fullcontacter.personLookup('YOUR API KEY HERE')

    # look up a name
    name = fc_name.lookitup(fname='Patrick', lname='Russell')

    # look up a person via twitter
    person_twitter = fc_person.lookitup('patrickrm101', 'twitter')

    # look up a person via email
    person_email = fc_person.lookitup('')

    return name, person_twitter, person_email

if __name__ == "__main__":


Code is hosted on github here: Github Repository


support vcard Test coverage. Implement a better API and include more of the lookup options, including account status.


First attempt at releasing something to the public. I’m pretty new to this, tips, ideas, criticism, all welcome.

Project details

Download files

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

Files for fullcontacter, version 0.3.1
Filename, size File type Python version Upload date Hashes
Filename, size fullcontacter-0.3.1.tar.gz (4.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page