Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

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.

Release History

This version
History Node


History Node


History Node


History Node


History Node


Download Files

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

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(4.2 kB) Copy SHA256 Hash SHA256
Source Jan 27, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting