Skip to main content

# Clearbit

A Python API client to [https://clearbit.com](https://clearbit.com).

## Installation

To install the Clearbit Python bindings, run:

pip install clearbit

Or

easy_install clearbit

## Usage

First authorize requests by setting the API key found on your [account’s settings page](https://clearbit.com/keys).

`python import clearbit clearbit.key = 'mykey' `

You can also set the API key via the CLEARBIT_KEY environment variable.

Then you can lookup people by email address. If the email’s domain is corporate we’ll also return a company response.

`python response = clearbit.Enrichment.find(email='alex@clearbit.com',stream=True) `

See the [documentation](https://clearbit.com/docs#person-api) for more information.

## Company lookup

You can lookup company data by domain name:

`python company = clearbit.Company.find(domain='uber.com',stream=True) `

If the company can’t be found, then None will be returned.

See the [documentation](https://clearbit.com/docs#company-api) for more information.

## Testing

Set the PYTHONPATH env var to the current directory to load the library locally:

export PYTHONPATH=.

## Deploy

python setup.py sdist upload -r pypi

Release files for clearbit 0.1.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for clearbit 0.1.7
File Size Uploaded
clearbit-0.1.7.tar.gz 5.0 kB Details

Release files / clearbit-0.1.7.tar.gz

Download URL clearbit-0.1.7.tar.gz
Size 5.0 kB
Tags Source
SHA-256 checksum
How to use checksums
f1d5b854a9b0e8d6644bad2594f9e65ab756ffb0c6c34db15ecfc1e9179bb883
BLAKE2b-256 checksum
How to use checksums
50e7bbd7c4525cb4ecb74fbe7f4dff6f4112342d9050d64b3be8d56b8c0a028b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.1.7 This release

1 release file

0.1.6

1 release file

0.1.5

1 release file

0.1.4

1 release file

0.1.3

1 release file

0.1.2

1 release file

0.1.1

1 release file

0.1.0

1 release file

0.0.8

1 release file

0.0.7

1 release file

0.0.6

1 release file

0.0.5

1 release file

0.0.4

1 release file

0.0.3

0.0.2

1 release file

0.0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page