Data Enrich API Reference

Introduction #

Data Enrich gives you two things most tools keep apart: the professional side of a person or company (role, firmographics, verified contact details) and their live social side (audience, engagement, recent content) across 30+ platforms. You can call the unified enrich endpoint to get everything in one response, or call any single endpoint on its own.

Every response is JSON, every request needs one header, and there is no SDK to install. If you prefer, drop the official MCP server or CLI into your stack and your agents can call every endpoint below.

Authentication #

Authenticate every request with your secret key in the x-api-key header. Keep it server side. You can create and roll keys from your dashboard.

# every request carries one header
curl https://api.dataenrich.tech/v1/company?domain=northwind.io \
  -H "x-api-key: YOUR_KEY"

Quickstart #

Grab a key, then resolve your first profile in one call. This takes one identifier (an email, a company domain, or a social handle) and returns the merged record.

curl -X POST https://api.dataenrich.tech/v1/enrich \
  -H "x-api-key: YOUR_KEY" \
  -H "content-type: application/json" \
  -d '{ "handle": "@jordan.builds" }'

{
  "person":  { "name": "Jordan Rivera", "title": "Head of Growth" },
  "company": { "name": "Northwind Labs" },
  "social":  { "tiktok": { "followers": 1240000 } },
  "match_confidence": 0.97
}

Credits & rate limits #

Usage is metered in credits. Standard endpoints cost 1 credit per call. LinkedIn is the one premium endpoint and bills at a flat rate, separately from your credit balance. Credits never expire, and there are no per-minute rate limits. We ask that you stay under 500 concurrent requests.

Check your balance any time with GET /v1/credits.

Errors #

Data Enrich uses standard HTTP status codes. Error bodies always include a machine-readable code and a human-readable message.

{
  "error": {
    "code": "insufficient_credits",
    "message": "You have 0 credits left.",
    "status": 402
  }
}

Pagination #

List endpoints (posts, videos, comments, followers) use cursor pagination. Pass the cursor from the previous response to fetch the next page. When next_cursor is null, you have reached the end.

# fetch the next page of a creator's videos
curl "https://api.dataenrich.tech/v1/social/tiktok/profile/videos?handle=@jordan.builds&cursor=eyJ..." \
  -H "x-api-key: YOUR_KEY"

Unified enrich #

POST /v1/enrich

The flagship endpoint. Give it one identifier and it resolves the entity, pulls company and contact data, finds the matching social profiles, and returns one merged record with a match confidence score.

Body parameters

curl -X POST https://api.dataenrich.tech/v1/enrich \
  -H "x-api-key: YOUR_KEY" \
  -H "content-type: application/json" \
  -d '{ "email": "jordan@northwind.io" }'

{
  "person": {
    "name": "Jordan Rivera",
    "title": "Head of Growth",
    "seniority": "director",
    "location": "Austin, TX"
  },
  "company": {
    "name": "Northwind Labs",
    "domain": "northwind.io",
    "revenue": "50-100M",
    "employees": 240,
    "industry": "SaaS"
  },
  "contact": {
    "email": "jordan@northwind.io",
    "email_status": "verified",
    "phone": "+1-512-555-0134"
  },
  "social": {
    "tiktok":    { "handle": "@jordan.builds", "followers": 1240000, "engagement_rate": 0.068 },
    "instagram": { "handle": "@jordan.builds", "followers": 486000 },
    "youtube":   { "subscribers": 92100 }
  },
  "match_confidence": 0.97,
  "credits_used": 1
}

Person #

GET /v1/person

Resolve a single person to their role, seniority, and verified contact details.

curl "https://api.dataenrich.tech/v1/person?email=jordan@northwind.io" \
  -H "x-api-key: YOUR_KEY"

Company #

GET /v1/company

Firmographics for any company: industry, revenue band, headcount, location, and domain.

curl "https://api.dataenrich.tech/v1/company?domain=northwind.io" \
  -H "x-api-key: YOUR_KEY"

{
  "name": "Northwind Labs",
  "domain": "northwind.io",
  "industry": "SaaS",
  "revenue": "50-100M",
  "employees": 240,
  "hq": "Austin, TX",
  "founded": 2016
}

Technographics #

GET /v1/company/technographics

The tools and platforms a company runs, from CRM to cloud to analytics.

{ "domain": "northwind.io",
  "stack": ["HubSpot", "Segment", "AWS", "Snowflake"] }

Activity #

GET /v1/person/activity

A person's recent professional social activity: posts, comments, and reactions, with engagement counts.

TikTok #

Profiles, videos, transcripts, comments, audience demographics, search, and trends. Base path /v1/social/tiktok.

curl "https://api.dataenrich.tech/v1/social/tiktok/profile?handle=@jordan.builds" \
  -H "x-api-key: YOUR_KEY"

{
  "handle": "@jordan.builds",
  "nickname": "Jordan Rivera",
  "verified": true,
  "followers": 1240000,
  "following": 812,
  "likes": 48200000,
  "video_count": 743,
  "credits_used": 1
}

Instagram #

Profiles, posts, reels, comments, transcripts, highlights, and search. Base path /v1/social/instagram.

YouTube #

Channels, videos, shorts, transcripts, comments, playlists, and search. Base path /v1/social/youtube.

X #

Profiles, tweets, transcripts, and communities. Base path /v1/social/x.

LinkedIn #

Public profiles, company pages, and posts. Base path /v1/social/linkedin.

Facebook #

Pages, posts, reels, photos, groups, comments, and transcripts. Base path /v1/social/facebook.

Reddit #

Subreddits, posts, comments, and search. Base path /v1/social/reddit.

Threads #

Profiles, posts, and user search. Base path /v1/social/threads.

Bluesky #

Profiles and posts. Base path /v1/social/bluesky.

Pinterest #

Search, pins, and boards. Base path /v1/social/pinterest.

Twitch, Snapchat, Rumble, Truth Social, Kick, Kwai #

Additional platforms under /v1/social.

Ads intelligence #

See what any company is running across the major ad libraries. Base path /v1/ads.

Shops #

Products from creator and social shops. Base path /v1/shop.

Music #

Artists and tracks across the major music platforms. Base path /v1/music.

Link-in-bio #

Resolve the links behind a creator's bio page. Base path /v1/linkinbio. Each takes a url.

Search, GitHub, tools #

Supporting endpoints for search, developer profiles, image analysis, and account usage.