# LeadMagic

> Find, verify and enrich people and companies with LeadMagic, and monitor credits, usage and bulk jobs.

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/leadmagic

## Actions

### Check credits

Check Credits.

**Inputs**: None.

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "credits": 0
  },
  "has_more": false,
  "next_cursor": null
}
```

### Detect job change

Job Change Detector.

**Inputs**

- Profile URL (`profile_url`, text, required): Professional profile URL or identifier
- Company name (`company_name`, text): Expected company name (either company_name or company_domain is required)
- Company domain (`company_domain`, text): Expected company domain (either company_name or company_domain is required)

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "credits_consumed": 0,
    "current_company": "",
    "current_position": {
      "company": "",
      "days_at_job": 0,
      "is_current_position": false,
      "start_date": "",
      "tenure_formatted": "",
      "title": ""
    },
    "employee_name": "",
    "expected_company": "",
    "job_change_detected": false,
    "profile_found": false,
    "profile_url": "",
    "resolution_reason": "CURRENT_COMPANY_MATCHES_EXPECTED",
    "status": "NO_CHANGE",
    "summary": "",
    "tenure_stats": {
      "average_tenure_formatted": "",
      "average_tenure_months": 0,
      "longest_tenure_formatted": "",
      "longest_tenure_months": 0,
      "shortest_tenure_formatted": "",
      "shortest_tenure_months": 0,
      "total_positions": 0
    },
    "work_history": []
  },
  "has_more": false,
  "next_cursor": null
}
```

### Enrich email

Email Address to B2B Person Profile.

**Inputs**

- Work email (`work_email`, text): Provide the Work Email of the person
- Personal email (`personal_email`, text): Provide the Personal Email of the person

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "credits_consumed": 0,
    "message": "",
    "profile_url": ""
  },
  "has_more": false,
  "next_cursor": null
}
```

### Find competitors

Competitors Search.

**Inputs**

- Company domain (`company_domain`, text): Company website domain
- Company URL (`company_url`, text): Company profile URL or identifier (optional)
- Company name (`company_name`, text): Company name

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "competitors": []
  },
  "has_more": false,
  "next_cursor": null
}
```

### Find email

Email Finder.

**Inputs**

- First name (`first_name`, text): First name of the person (optional if full_name provided). A single initial (`J`) is accepted when `last_name` is a full surname.
- Last name (`last_name`, text): Last name of the person (optional)
- Full name (`full_name`, text): Full name of the person (alternative to first_name + last_name). An initial plus a surname (`J Orjuela`) is accepted.
- Domain (`domain`, text): Company domain name (required if company_name not provided; aliases company_domain, website, url accepted)
- Company name (`company_name`, text): Company name (required if domain not provided; aliases company, organization, employer accepted)
- Profile URL (`profile_url`, text): B2B profile URL or username. Identifies the person and their company on its own, then the email is validated the same way as a name plus domain.
- Allow domain mismatch (`allow_domain_mismatch`, true/false): By default, an email found on a domain unrelated to the requested one is returned as a free not-found (`domain_mismatch: true`, `credits_consumed: 0`). Set to `true` to return that email instead, flagged `domain_mismatch: true` and charged like any other valid find.

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "company_facebook_url": "",
    "company_founded": 0,
    "company_industry": "",
    "company_location": {
      "address_line_2": "",
      "continent": "",
      "country": "",
      "geo": "",
      "locality": "",
      "metro": "",
      "name": "",
      "postal_code": "",
      "region": "",
      "street_address": ""
    },
    "company_name": "",
    "company_profile_id": "",
    "company_profile_url": "",
    "company_size": "",
    "company_twitter_url": "",
    "company_type": "",
    "credits_consumed": 0,
    "domain": "",
    "domain_mismatch": false,
    "email": "",
    "employment_verified": null,
    "first_name": "",
    "has_mx": false,
    "last_name": "",
    "message": "",
    "mx_provider": "",
    "mx_record": "",
    "mx_records_full": [],
    "mx_security_gateway": false,
    "requested_domain": "",
    "status": ""
  },
  "has_more": false,
  "next_cursor": null
}
```

### Find employees

Employee Finder.

**Inputs**

- Company domain (`company_domain`, text): Company website domain (preferred: more accurate than company_name)
- Company name (`company_name`, text): Company name. Use if domain is not available.
- Limit (`limit`, number): Maximum number of employees to return

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "credits_consumed": 0,
    "employees": [],
    "message": "Employees found.",
    "total_count": 0
  },
  "has_more": false,
  "next_cursor": null
}
```

### Find lookalike companies

Company Lookalike.

**Inputs**

- Company domain (`company_domain`, text): Seed company domain. Aliases include domain, website, company_website, seed.domain. Typos like companny_domain are remapped.
- Domain (`domain`, text): Alias for company_domain.
- Website (`website`, text): Seed website URL or domain.
- Company website (`company_website`, text): Alias for website.
- Company name (`company_name`, text): Seed company name used as text intent when no domain is supplied.
- Name (`name`, text): Alias for company_name.
- Description (`description`, text): Free-text seed description.
- Company description (`company_description`, text): Alias for description.
- Seed (`seed`, object): Optional seed object. Prefer seed.domain.
- Company filters (`company_filters`, object): Subset of the Company Search filters: HQ country_codes, employee_ranges, min/max_employees, revenue_ranges, min/max_revenue, industries, sic_codes, naics_codes, founded_after/before, min_linkedin_followers, has_funding, min/max_total_funding, min/max_valid_email_count, website_active, has_tech_stack, tech_stack, and the *_tech technographic columns. Other Company Search filters (e.g. presence location_country_codes, hq_city) are echoed in interpreted_search but not applied. Alias filters.
- Filters (`filters`, object): Alias for company_filters.
- Preview (`preview`, true/false): Free preview: chatbot UI only. API/MCP clients receive 400.
- Limit (`limit`, number): Page size. Pages hold at most 100 companies: values 101-2000 are clamped to 100 (metadata.limit_clamped, requested_limit, applied_limit, and a Warning header); values above 2000 return 400. Page with offset = metadata.next_offset. Typos like limmit are remapped. From 1 to 2000.
- Offset (`offset`, number): Offset into the similarity ranking (100, 200, …). Lookalike has no cursor. Deeper pages take longer. From 0 to 2000.

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "companies": [],
    "count": 0,
    "credits_consumed": 0,
    "interpreted_search": {},
    "limit_applied": 0,
    "message": "",
    "metadata": {
      "applied_limit": 0,
      "degraded": false,
      "has_more": false,
      "limit_clamped": false,
      "next_offset": null,
      "preview": false,
      "query_name": "",
      "query_path": "",
      "requested_limit": 0
    },
    "offset": 0,
    "returned_count": 0
  },
  "has_more": false,
  "next_cursor": null
}
```

### Find mobile

Mobile Finder.

**Inputs**

- Profile URL (`profile_url`, text): Provide their Social Media URL
- Work email (`work_email`, text): Provide the Work Email of the person
- Personal email (`personal_email`, text): Provide the Personal Email of the person

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "credits_consumed": 0,
    "email": null,
    "message": "",
    "mobile_number": null,
    "profile_url": null
  },
  "has_more": false,
  "next_cursor": null
}
```

### Find personal email

Personal Email Finder.

**Inputs**

- Profile URL (`profile_url`, text, required): Professional profile URL or identifier

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "credits_consumed": 0,
    "first_personal_email": "",
    "message": "",
    "name": "",
    "personal_emails": [],
    "profile_url": ""
  },
  "has_more": false,
  "next_cursor": null
}
```

### Find profile email

B2B Person Profile to Email.

**Inputs**

- Profile URL (`profile_url`, text, required): B2B person profile URL or slug

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "credits_consumed": 0,
    "email": "",
    "message": "",
    "profile_url": ""
  },
  "has_more": false,
  "next_cursor": null
}
```

### Find role

Role Finder.

**Inputs**

- Company name (`company_name`, text): Business Profile URL (with url or public_identifier)
- Company domain (`company_domain`, text): Company domain
- Job title (`job_title`, text): Enter the job title you want to find in the company.

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "company_name": "",
    "company_website": "",
    "credits_consumed": 0,
    "first_name": "",
    "last_name": "",
    "message": "",
    "name": "",
    "profile_url": ""
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get bulk job

Get Bulk Job Status.

**Inputs**

- JobId (`jobId`, text, required): UUID identifier of the bulk job.

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "callback_event": null,
    "callback_url": null,
    "completed_at": null,
    "created_at": "",
    "execution_mode": null,
    "failed_items": 0,
    "file_name": null,
    "job_id": "",
    "last_progress_at": null,
    "links": {
      "downloadUrl": "",
      "errorsUrl": "",
      "eventsExportUrl": "",
      "eventsUrl": "",
      "exp": 0,
      "logsUrl": "",
      "progressUrl": "",
      "resultsUrl": "",
      "rowsUrl": "",
      "statusUrl": "",
      "streamUrl": "",
      "token": "",
      "wsUrl": ""
    },
    "output_transform": null,
    "priority": null,
    "processed_items": 0,
    "products": null,
    "skipped_items": 0,
    "started_at": null,
    "status": "",
    "submission_endpoint": null,
    "submission_product": null,
    "succeeded_items": 0,
    "total_credits_consumed": null,
    "total_duration_ms": null,
    "total_rows": 0
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get company funding

Company Funding.

**Inputs**

- Company name (`company_name`, text): Provide Company Name
- Company domain (`company_domain`, text): Provide Company Domain

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "acquisitions": [],
    "basicInfo": {
      "companyName": "",
      "description": "",
      "followers": 0,
      "founded": "",
      "headquarters": {
        "city": "",
        "country": "",
        "fullAddress": "",
        "state": ""
      },
      "ownership": "",
      "phone": "",
      "primaryDomain": "",
      "shortName": "",
      "status": ""
    },
    "companySize": {
      "employeeGrowth": "",
      "employeeRange": "",
      "employees": 0
    },
    "credits_consumed": 0,
    "financialInfo": {
      "formattedFunding": "",
      "formattedRevenue": "",
      "lastFundingRound": {
        "amount": 0,
        "date": "",
        "round": ""
      },
      "revenue": 0,
      "totalFunding": 0
    },
    "fundingHistory": [],
    "industryAndSectors": {
      "industries": [],
      "industrySectors": [],
      "technologyStack": ""
    },
    "keyHighlights": [],
    "leadership": {
      "ceo": {
        "b2b_profile": "",
        "designation": "",
        "firstName": "",
        "lastName": "",
        "twitter": ""
      }
    },
    "news": [],
    "pressReleases": [],
    "socialMedia": [],
    "summarySection": "",
    "topCompetitors": []
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get daily metrics

Daily Metrics.

**Inputs**

- Days (`days`, number): Number of days to include (1-90). From 1 to 90.

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "data": [],
    "period": {
      "days": 0,
      "end": "",
      "start": ""
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get product usage

Products Breakdown.

**Inputs**

- Days (`days`, number): Number of days to include (1-90). From 1 to 90.

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "daily": [],
    "period": {
      "days": 0,
      "end": "",
      "start": ""
    },
    "products": {}
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get search statistics

Search Stats.

**Inputs**

- Products (`products`, list): Search products to include: jobs, company, and/or people stats. One or more of: `jobs`, `company`, `people`.
- Sections (`sections`, list): Stat sections to return: coverage counts, top dimensions, and/or filter capabilities. One or more of: `coverage`, `top`, `capabilities`.
- Limit (`limit`, number): Max top values per dimension. Defaults to 3. From 1 to 25.

**Outputs**

- `data` (object): Complete service response. May be empty after a successful write.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": null,
  "has_more": false,
  "next_cursor": ""
}
```

### Get technographics

Company Technographics.

**Inputs**

- Company domain (`company_domain`, text, required): The domain of the company to analyze

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "credits_consumed": 0,
    "data": [],
    "message": ""
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get usage

Usage Summary.

**Inputs**

- Days (`days`, number): Number of days to include (1-90). From 1 to 90.

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "daily": [],
    "period": {
      "days": 0,
      "end": "",
      "start": ""
    },
    "summary": {
      "avg_credits_per_request": 0,
      "chargeable_rate": 0,
      "chargeable_requests": 0,
      "total_credits": 0,
      "total_requests": 0,
      "unique_products": 0
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### List bulk jobs

List Bulk Jobs.

**Inputs**

- Status (`status`, text): Filter jobs by current status.
- Product (`product`, text): Filter jobs by enrichment product.
- Limit (`limit`, number): Number of jobs per page. From 1 to 200.
- Offset (`offset`, number): Number of jobs to skip. From 0 to 10000.

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "jobs": [],
    "limit": 0,
    "offset": 0
  },
  "has_more": false,
  "next_cursor": null
}
```

### Search companies

Company Search.

**Inputs**

- Company domain (`company_domain`, text): Direct one-company lookup input. Returns one rich company row plus legacy-friendly aliases when no broad filters or explicit limit are supplied.
- Domain (`domain`, text): Alias for company_domain.
- Website (`website`, text): Company website URL or domain.
- Company name (`company_name`, text): Company name lookup input.
- Profile URL (`profile_url`, text): Company profile URL.
- Linkedin URL (`linkedin_url`, text): Company profile URL.
- Company filters (`company_filters`, object): Full company filter object.
- Query (`query`, text): Query.
- Limit (`limit`, number): Limit. From 1 to 50.
- Cursor (`cursor`, text): Opaque next_cursor from the previous page. Send unchanged with the same filters and limit.
- Offset (`offset`, number): Legacy offset pagination; prefer cursor. Unstable ordering, uncached. Restart at offset 0 to obtain a cursor. At least 0.

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "companies": [],
    "company": null,
    "companyDomain": null,
    "companyName": null,
    "count": 0,
    "credits_consumed": 0,
    "found": false,
    "has_more": false,
    "interpreted_search": {},
    "limit_applied": 0,
    "linkedinUrl": null,
    "message": "",
    "metadata": {
      "pagination": "snapshot"
    },
    "next_cursor": null,
    "offset": 0,
    "returned_count": 0,
    "websiteUrl": null
  },
  "has_more": false,
  "next_cursor": null
}
```

### Search company

Company Search.

**Inputs**

- Profile URL (`profile_url`, text): Business company profile URL or identifier
- Company domain (`company_domain`, text): Provide Company Domain
- Company name (`company_name`, text): Provide Company Name

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "acquisitions_count": null,
    "b2b_profile_url": null,
    "companyId": 0,
    "companyName": "",
    "competitors": null,
    "credits_consumed": 0,
    "data_source": "live",
    "description": "",
    "employeeCount": 0,
    "employeeCountRange": {
      "end": 0,
      "start": 0
    },
    "employee_range": null,
    "facebook_url": null,
    "followerCount": 0,
    "foundedOn": {
      "day": null,
      "month": null,
      "year": 0
    },
    "founded_year": null,
    "funding_rounds": null,
    "hashtag": "",
    "headquarter": {
      "city": "",
      "country": "",
      "description": "",
      "geographicArea": "",
      "line1": "",
      "line2": null,
      "postalCode": ""
    },
    "industry": "",
    "last_funding_amount": null,
    "last_funding_date": null,
    "last_funding_round": null,
    "locations": [],
    "logo_url": null,
    "message": "",
    "ownership_status": null,
    "revenue": null,
    "revenue_formatted": null,
    "specialities": [],
    "stock_ticker": null,
    "tagline": "",
    "total_funding": null,
    "twitter_url": null,
    "universalName": "",
    "url": "",
    "websiteUrl": ""
  },
  "has_more": false,
  "next_cursor": null
}
```

### Search jobs

Job Search.

**Inputs**

- Titles (`titles`, object): Titles.
- OccupationTaxonomy (`occupationTaxonomy`, object): Occupationtaxonomy.
- Companies (`companies`, object): Companies.
- Location (`location`, object): Location.
- Tags (`tags`, object): Tags.
- Salary (`salary`, object): Salary.
- Seniority (`seniority`, list): Seniority.
- PostedAfter (`postedAfter`, date and time): Postedafter.
- PostedBefore (`postedBefore`, date and time): Postedbefore.
- PostedWithin (`postedWithin`, number): Include jobs posted within the last N days.
- Languages (`languages`, list): Languages.
- HasRemote (`hasRemote`, true/false): Hasremote.
- JobTypeIds (`jobTypeIds`, list): Jobtypeids.
- IndustryIds (`industryIds`, list): Industryids.
- CompanyTypeIds (`companyTypeIds`, list): Companytypeids.
- CompanySizeCodes (`companySizeCodes`, list): Companysizecodes.
- Limit (`limit`, number): Limit. At most 50.
- Cursor (`cursor`, text): Opaque cursor from pagination.next_cursor. Send unchanged with the same filters and limit.
- IncludeDescription (`includeDescription`, true/false): Include job description text. Enabling descriptions may increase response time.
- IncludeFacets (`includeFacets`, true/false): Include facet metadata. Enabling facets may increase response time.
- TotalMode (`totalMode`, text): Totalmode. One of: `none`, `capped`, `exact`.
- Mode (`mode`, text): fast returns paginated browsing results when descriptions and facets are omitted; deep enables broader text matching. One of: `fast`, `deep`.
- AutoResolve (`autoResolve`, true/false): Autoresolve.

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "credits_consumed": 0,
    "has_more": false,
    "next_cursor": null,
    "pagination": {
      "has_more": false,
      "limit": 0,
      "next_cursor": null,
      "returned": 0
    },
    "resolved": {},
    "signals": [],
    "total": 0,
    "totalMode": ""
  },
  "has_more": false,
  "next_cursor": null
}
```

### Search people

People Search.

**Inputs**

- Company domain (`company_domain`, text): Company domain.
- Company name (`company_name`, text): Company name.
- Linkedin URL (`linkedin_url`, text): B2B company profile URL or slug.
- Company filters (`company_filters`, object): Criteria-based company set. Supports the full Company Search filter family.
- People filters (`people_filters`, object): People-level filters for names, title/function/level, geography, profile URLs, headline/about-me/industry, languages, seniority, connection count, and channel availability. Canonical keys use the contact_* prefix (e.g. contact_linkedin_about_me); bare aliases such as about_me, headline, industry, job_function, and city are accepted. contact_job_function accepts short chips (Sales, Marketing, Finance, …) or full standard labels (Sales & Business Development, …); matching is exact after chip→label expansion and response rows always return the standard label. Multiple values in one array are OR'd; different people_filters keys in one request are AND'd. Keys the search cannot honor are echoed in interpreted_search.ignored_people_filters rather than silently dropped.
- Title (`title`, text): Title.
- Job title (`job_title`, text): Job title.
- Titles (`titles`, list): Titles.
- Roles (`roles`, list): Roles.
- Query (`query`, text): Free-text people/title query.
- Required email (`required_email`, true/false): Only return people with email availability.
- Required mobile (`required_mobile`, true/false): Only return people with mobile availability.
- Channels (`channels`, list): Legacy alias for contactability requirements. One or more of: `email`, `phone`.
- Channel match (`channel_match`, text): Channel match. One of: `any`, `all`.
- Include company (`include_company`, true/false): Include company.
- Include domain intel (`include_domain_intel`, true/false): Include domain intel.
- Include contact details (`include_contact_details`, true/false): Retired contact-detail option. Omit it or use false; true is rejected with 400 on every plan. Use a separate Email Finder or Mobile Finder request. One of: `false`.
- Include email (`include_email`, true/false): Retired email option. Omit it or use false; true is rejected with 400 on every plan. Use a separate Email Finder request. One of: `false`.
- Include mobile (`include_mobile`, true/false): Retired mobile option. Omit it or use false; true is rejected with 400 on every plan. Use a separate Mobile Finder request. One of: `false`.
- Confirm credit charge (`confirm_credit_charge`, true/false): Accepted for backwards compatibility; not required and does not enable contact values in search.
- Limit (`limit`, number): Offset requests allow up to 10000 rows; cursor-based pages are capped at 50. From 1 to 10000.
- Cursor (`cursor`, text): Opaque signed next_cursor from the previous page. Send unchanged with the same filters, a limit no greater than 50, and offset 0.
- Offset (`offset`, number): Legacy offset pagination; prefer cursor. Unstable ordering, uncached. Restart at offset 0 to obtain a cursor. At least 0.

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "companies": [],
    "count": 0,
    "credit_preview": {},
    "credits_consumed": 0,
    "has_more": false,
    "limit_applied": 0,
    "message": "",
    "metadata": {
      "pagination": "snapshot"
    },
    "next_cursor": null,
    "offset": 0,
    "people": [],
    "returned_count": 0
  },
  "has_more": false,
  "next_cursor": null
}
```

### Search person profile

B2B Person Profile.

**Inputs**

- Profile URL (`profile_url`, text, required): B2B person profile URL or slug

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "bio": null,
    "certifications": null,
    "company_industry": null,
    "company_name": null,
    "company_website": null,
    "country": null,
    "credits_consumed": 0,
    "education": null,
    "first_name": null,
    "followers_range": null,
    "full_name": null,
    "honors": null,
    "last_name": null,
    "location": null,
    "personal_website": null,
    "professional_title": null,
    "profile_url": "",
    "total_tenure_days": null,
    "total_tenure_months": null,
    "total_tenure_years": null,
    "work_experience": null
  },
  "has_more": false,
  "next_cursor": null
}
```

### Validate email

Email Validation.

**Inputs**

- Email (`email`, text, required): Email address to validate

**Outputs**

- `data` (object): Complete service response.
- `has_more` (true/false): Whether the service reports another page.
- `next_cursor` (text): Cursor for the next page, when supplied by the service.

**Example output**

```json
{
  "data": {
    "company_facebook_url": null,
    "company_founded": 0,
    "company_industry": "",
    "company_linkedin_id": "",
    "company_linkedin_url": "",
    "company_location": {
      "address_line_2": null,
      "continent": "",
      "country": "",
      "geo": null,
      "locality": "",
      "metro": "",
      "name": "",
      "postal_code": "",
      "region": "",
      "street_address": ""
    },
    "company_name": "",
    "company_size": "",
    "company_twitter_url": null,
    "company_type": "",
    "credits_consumed": 0,
    "email": "",
    "email_status": "",
    "message": "",
    "mx_gateway": null,
    "mx_gateway_type": null,
    "mx_provider": "",
    "mx_record": "",
    "mx_security_gateway": false
  },
  "has_more": false,
  "next_cursor": null
}
```
