Migrating from Proxycurl

Coming from Proxycurl (or a Proxycurl-style API)? The resource layout will feel familiar — that’s deliberate. Here’s the whole migration.

Auth

	Proxycurl	Up2Data
Header	`Authorization: Bearer <token>`	`X-API-Key: u2d_live_…`
Webhook test	—	`POST /v1/signals/{id}/test-webhook` (free)

Endpoint mapping

Proxycurl	Up2Data	Notes
`GET /api/v2/linkedin` (Person Profile)	`POST /v1/profiles/enrich`	URL goes in the body, not a query param.
Person Lookup by name/company	`POST /v1/search/people` → `enrich`	Search stubs, then hydrate. No email products — pure profile scraping.
`GET /api/linkedin/company`	`POST /v1/companies/enrich`
Person Search API	`POST /v1/search/people`	1 credit/page of 25 vs per-result pricing.
Jobs endpoints	`POST /v1/search/jobs`
— (no equivalent)	`POST /v1/signals`	Change monitoring with webhook diffs.

Request shape

Proxycurl is GET-with-query-params; Up2Data is POST-with-JSON-body:

curl -G https://nubela.co/proxycurl/api/v2/linkedin \
  -H "Authorization: Bearer $PROXYCURL_TOKEN" \
  --data-urlencode "linkedin_profile_url=https://linkedin.com/in/satyanadella"

curl -X POST https://api.up2data.ai/v1/profiles/enrich \
  -H "X-API-Key: $UP2DATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://linkedin.com/in/satyanadella"}'

Response shape

Payload is under data (Proxycurl returns fields at the top level).
Field names are close but not identical — e.g. experiences[] → positions[], city/state/country → location.{city,region,country}. Full glossary on each endpoint page.
Every response includes meta.creditsUsed / creditsRemaining — no separate balance endpoint calls needed (though GET /v1/account exists and is free).

Billing differences that matter

	Proxycurl-style	Up2Data
Data freshness	Cached DB with `use_cache` flags	Always live — every call is a fresh scrape
Failed lookups	Varies by endpoint	Never billed (pay-on-success)
Credit expiry	Monthly expiration on subscriptions	Never expire
Price at scale	~$10+/1K	$2.50 →$ 0.50 per 1K as volume grows (graduated)

Migration checklist

Swap auth header and base URL

Authorization: Bearer → X-API-Key, nubela.co/proxycurl → api.up2data.ai.

Convert GETs to POSTs

Query params become JSON body fields.

Remap response fields

Read from data.*; rename per the field glossaries.

Delete your cache-freshness logic

use_cache=if-recent workarounds are obsolete — everything is live.

Replace polling loops with Signals

If you re-scrape profiles on a schedule to detect changes, a Signal does it server-side and webhooks you the diff.

Overview

Enrichment

Signals

Migrations

Migrating from Proxycurl

Auth

Endpoint mapping

Request shape

Response shape

Billing differences that matter

Migration checklist

​Auth

​Endpoint mapping

​Request shape

​Response shape

​Billing differences that matter

​Migration checklist

Auth

Endpoint mapping

Request shape

Response shape

Billing differences that matter

Migration checklist