Back to APIs

Unified Agent API

Profile Finder

Profile Finder

Find and enrich professional profiles by LinkedIn URL or name, with waterfall across multiple data providers and merged results.

POST/v1/profiles/find

Overview

Your agent finds and enriches professional profiles. We waterfall across multiple data providers (Icypeas, LeadMagic, Exa), merge the best fields from each, and return one normalized profile. Provide a LinkedIn URL for direct lookup, or name + company for search-based discovery.

Parameters

linkedin_url

string

Direct LinkedIn profile URL. If provided, skips the search step and goes directly to enrichment. This is the fastest and most accurate path.

first_name

string

Person's first name. Required if linkedin_url is not provided. Used with last_name (and optionally company) to search for the profile.

last_name

string

Person's last name. Required if linkedin_url is not provided.

company

string

Company name to narrow the search. Highly recommended when using name-based lookup to improve match accuracy.

include_image

boolean (default: true)

Whether to fetch and re-host the profile image. Adds an Exa provider call to the waterfall. Images are re-hosted to avoid LinkedIn hotlinking blocks.

Example Response

{
  "success": true,
  "data": {
    "first_name": "John",
    "last_name": "Doe",
    "full_name": "John Doe",
    "headline": "CTO at Acme Corp",
    "company": "Acme Corp",
    "title": "CTO",
    "location": "San Francisco, CA",
    "summary": "Experienced technology leader with 15+ years...",
    "experience": [
      { "title": "CTO", "company": "Acme Corp", "period": "2023 - Present" }
    ],
    "education": [],
    "skills": ["Python", "Machine Learning", "System Design"],
    "profile_image_url": "https://cdn.o-mega.ai/profiles/abc.jpg",
    "linkedin_url": "https://linkedin.com/in/johndoe"
  },
  "metadata": {
    "provider_used": "merged",
    "providers_tried": ["icypeas", "leadmagic", "exa_image"],
    "response_time_ms": 4200,
    "request_id": "req_ghi789"
  },
  "credits_used": 3
}

Get Started

Use this API through the O-mega platform. Create an API key in your dashboard, then call the endpoint with your key in the Authorization header.

Try Profile Finder

Test Profile Finder in the interactive playground. No setup required.

Open Playground
Profile Finder API | Unified Agent APIs | o-mega