Authentication

Every request needs your API key, sent as either header:

X-API-Key: YOUR_KEY
# or
Authorization: Bearer YOUR_KEY

Create a free account to explore the dashboard, or subscribe directly from the pricing page — either way you'll find your key in the dashboard.

Search leads

Search Fyonta's owned contact database.

Param	Type	Notes
industry	string	Fuzzy match, e.g. IT Services
region_code	string	US state code, e.g. CA
seniority_tier	string	Comma-separated: C-Suite,VP,Director,Manager,Other
geo_bucket	string	US or a country code
min_quality	int	0–100 data quality score floor
min_icp	int	0–100 ICP match score floor
q	string	Fuzzy match on company name or title
limit / offset	int	Pagination, limit max 100

curl "https://api.fyonta.com/v1/leads/search?industry=IT+Services&seniority_tier=Director,VP,C-Suite&region_code=CA" \
  -H "X-API-Key: $FYONTA_KEY"

{
  "results": [{
    "company_name": "Robert Half",
    "domain": "roberthalf.com",
    "industry": "Staffing and Recruiting",
    "title": "VP, Talent Acquisition",
    "seniority_tier": "C-Suite",
    "email": "brooke.l@roberthalf.com",
    "data_quality_score": 100,
    "icp_match_score": 100
  }],
  "count": 1,
  "has_more": true,
  "offset": 0,
  "limit": 25
}

Search companies

Search Fyonta's owned firmographic database directly — no enrichment provider involved, so this never costs enrichment credits.

Param	Type	Notes
q	string	Fuzzy match on company name
domain	string	Exact match, e.g. acme.com
industry	string	Fuzzy match
region_code	string	State/region name
country_code	string	Country name
employee_count_range	string	Comma-separated, e.g. 1-10 or 11-50,51-200
limit / offset	int	Pagination, limit max 100

curl "https://api.fyonta.com/v1/leads/company-search?q=solar&country_code=Germany" \
  -H "X-API-Key: $FYONTA_KEY"

{
  "results": [{
    "company_name": "1stop solar gmbh",
    "domain": "1stopsolar.eu",
    "industry": "information technology and services",
    "employee_count_range": "11-50",
    "city": "eschborn",
    "region_code": "Hesse",
    "country_code": "Germany",
    "linkedin_url": "linkedin.com/company/1stop-solar-gmbh",
    "founded": "2023"
  }],
  "count": 1,
  "has_more": true,
  "offset": 0,
  "limit": 25
}

Enrichment endpoints

Live lookups for when your own list needs filling in.

Email search

Provide linkedin_url alone, or company_url + first_name + last_name.

Phone search

Same input rules as email search. Returns a direct or mobile number.

Reverse email lookup

Params: email (required). Identifies the person and title behind an address.

Domain search

Params: company_url, title, page, has_email. Lists contacts at a company.

Contact finder

Multi-filter prospecting. Body fields (title, locality, company_name, company_url, city, country_code, industry_linkedin, number_of_employees, revenue, bio_li, services) each take {"include": [...], "exclude": [...]}, plus has_email, has_phone, page, per_page.

curl -X POST https://api.fyonta.com/v1/enrich/contact-finder \
  -H "X-API-Key: $FYONTA_KEY" -H "Content-Type: application/json" \
  -d '{"title": {"include": ["CEO"]}, "country_code": {"include": ["US"]}}'

Company finder

Body fields (home_page_text, bio_li, services, industry, number_of_employees, revenue, country_code, city, company_name) each take {"include": [...], "exclude": [...]}, plus company_url, page, per_page.

MCP server

Point any MCP-compatible agent at Fyonta directly. Same key, same rate limits, same data as the REST API.

// mcp client config
{
  "fyonta": {
    "url": "https://api.fyonta.com/mcp",
    "headers": { "X-API-Key": "$FYONTA_KEY" }
  }
}

Available tools: search_leads, search_companies, enrich_email_search, enrich_phone_search, enrich_reverse_email_lookup, enrich_domain_search, enrich_contact_finder, enrich_company_finder — same parameters as their REST counterparts above.