proxycurl-py

What it is and what it does

proxycurl-py is the official Python client for Proxycurl, a managed API service that enriches and looks up LinkedIn profile and company data. It wraps HTTP calls to Proxycurl's endpoints, handling authentication via API key and automatically managing rate limits with exponential backoff. The library is designed around concurrency from the ground up and requires you to choose one of three concurrency models at install time: asyncio, gevent, or twisted. This design choice reflects the library's primary use case: making many API requests in parallel to achieve high throughput (the documentation mentions up to 432,000 profiles per day on default rate limits).

The package supports Python 3.7 through 3.12 and has zero runtime dependencies—it ships as a pure Python wheel. You provide your Proxycurl API key via environment variable or direct configuration, then use the client to enrich person and company profiles by URL, lookup people and companies by name or domain, reverse-lookup LinkedIn URLs from work email addresses, and process bulk enrichment jobs from CSV files. Error handling is built in for non-rate-limit failures via ProxycurlException.

Use it for:

• Enrich a batch of LinkedIn profile URLs with structured person data (name, title, company, contact info) in parallel using asyncio.
• Look up a person's LinkedIn profile URL given their first name, last name, and company domain.
• Reverse-lookup a LinkedIn profile URL from a work email address to find contact information.
• Enrich company profiles by URL to extract company metadata, size, industry, and other business intelligence.
• Process a CSV file of LinkedIn URLs concurrently to populate a CRM or database with enriched profile data.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Python client for the Proxycurl API that enriches and looks up LinkedIn profiles and company data through programmatic API calls.

Yes, with conditions. Install if you have a valid Proxycurl API subscription, need to enrich or lookup LinkedIn data programmatically, and are comfortable with a dormant library (686 days since last release). The zero-dependency design and built-in rate-limit handling are strong points. However, verify the license terms first, confirm the Proxycurl service is still active, and ensure your chosen concurrency model (asyncio, gevent, or twisted) remains compatible with your environment.

Install

proxycurl-py on PyPI

pip install proxycurl-py

uv add proxycurl-py

poetry add proxycurl-py

Installing proxycurl-py

Before you install

Low install friction with no runtime dependencies. Maintenance is dormant—last release was 686 days ago—so expect no active bug fixes or updates; use only if the API surface is stable and your needs are met by the current version.

License in practice

License treatment is unclear; no SPDX identifier or raw license text is available. Verify the actual license terms before using in production or distributing.

Quickstart

# Install with asyncio support
$ pip install 'proxycurl-py[asyncio]'

# Set your API key
export PROXYCURL_API_KEY='your_key_here'

# Enrich a LinkedIn profile
from proxycurl.asyncio import Proxycurl
import asyncio

proxycurl = Proxycurl()
person = asyncio.run(proxycurl.linkedin.person.get(
    url='https://www.linkedin.com/in/williamhgates/'
))
print(person)

You must obtain a Proxycurl API key by registering an account at nubela.co/proxycurl and set it as the PROXYCURL_API_KEY environment variable or inject it into the config.

Verify before relying

• Whether the Proxycurl API service itself remains active and supported by the provider.
• Current status of the GitHub repository (archived status not confirmed in fact sheet).
• Whether concurrency library extras (asyncio, gevent, twisted) are still compatible with modern versions of those libraries.

Package facts

Evidence: proxycurl_py-0.1.0.post2-py3-none-any.whl

Tags

More Internet packages