Rich Utilities

Contacts API

Find decision-makers and their contact information across Nordic companies. Contacts are sourced from websites, social profiles, and public registries.

GET/v1/contacts

Search Contacts

Search for contacts with advanced filtering options including industry, geography, quality scores, and department filters.

Query Parameters

  • Name
    company_id
    Type
    integer
    Description
    Filter by company ID
  • Name
    q
    Type
    string
    Description
    Search by name or email
  • Name
    source
    Type
    string
    Description
    Contact source: website, linkedin, facebook, twitter, manual
  • Name
    verified
    Type
    boolean
    Description
    Only verified contacts
  • Name
    has_email
    Type
    boolean
    Description
    Has email address
  • Name
    has_phone
    Type
    boolean
    Description
    Has phone number
  • Name
    department
    Type
    string
    Description
    Filter by department (e.g., Sales, Engineering)
  • Name
    job_title
    Type
    string
    Description
    Search by job title
  • Name
    seniority_level
    Type
    string
    Description
    executive, senior, manager, staff
  • Name
    min_quality_score
    Type
    integer
    Description
    Minimum quality score (0-100)
  • Name
    max_quality_score
    Type
    integer
    Description
    Maximum quality score (0-100)
  • Name
    min_confidence
    Type
    float
    Description
    Minimum confidence score (0.0-1.0)
  • Name
    max_confidence
    Type
    float
    Description
    Maximum confidence score (0.0-1.0)
  • Name
    email_status
    Type
    string
    Description
    valid, catch_all, pending, invalid
  • Name
    exclude_stale
    Type
    boolean
    Description
    Exclude outdated contacts (default: true)
  • Name
    exclude_speculative
    Type
    boolean
    Description
    Exclude speculative contacts (default: true)
  • Name
    industry_id
    Type
    integer[]
    Description
    Filter by industry IDs (comma-separated)
  • Name
    industry_section
    Type
    string[]
    Description
    Filter by NACE sections A-U (comma-separated)
  • Name
    industry_level
    Type
    integer[]
    Description
    Filter by NACE hierarchy level (1-5)
  • Name
    country_code
    Type
    string[]
    Description
    Filter by country codes ISO 3166-1 alpha-2
  • Name
    exclude_industry_id
    Type
    integer[]
    Description
    Exclude industry IDs
  • Name
    exclude_country_code
    Type
    string[]
    Description
    Exclude country codes
  • Name
    sort_by
    Type
    string
    Description
    quality_score, confidence, created_at, full_name
  • Name
    sort_order
    Type
    string
    Description
    asc, desc (default: desc)
  • Name
    cursor
    Type
    string
    Description
    Pagination cursor
  • Name
    limit
    Type
    integer
    Description
    Results per page (1-100, default: 50)

See the NACE Codes Reference for industry section codes.

Request

GET
/v1/contacts

Response

Query Parameters

The contacts endpoint supports extensive filtering capabilities:

Basic Filters

  • company_id: Filter to contacts from a specific company
  • q: Full-text search across name and email
  • source: Filter by data source (website, linkedin, facebook, twitter, manual)
  • verified: Only return verified contact information
  • has_email/has_phone: Filter by contact method availability

Industry & Geography

Use these filters to target contacts in specific industries or countries:

See the NACE Codes Reference for all industry section codes.

Job & Department

  • department: Filter by department name (e.g., "Sales", "Engineering", "Marketing")
  • job_title: Partial match on job title
  • seniority_level: executive, senior, manager, or staff

Quality & Confidence

Contact quality is scored on multiple dimensions:

  • quality_score: Overall quality rating (0-100)
  • confidence: Data confidence level (0.0-1.0)
  • email_status: Email deliverability status
  • exclude_stale: Filter out outdated contacts (default: true)
  • exclude_speculative: Filter out inferred contacts (default: true)

Sorting & Pagination

  • sort_by: quality_score, confidence, created_at, or full_name
  • sort_order: asc or desc (default: desc)
  • cursor: Pagination cursor for next page
  • limit: Results per page (1-100, default: 50)

Contact Sources

Contacts are gathered from multiple sources with varying reliability:

SourceDescriptionTypical Quality
websiteScraped from company websitesHigh
linkedinLinkedIn company profilesHigh
facebookFacebook business pagesMedium
twitterTwitter/X profilesMedium
manualUser-contributed dataVariable

Schema

Contact Object

FieldTypeDescription
idintegerUnique contact ID
company_idintegerAssociated company ID
full_namestringFull name
job_titlestringJob title
emailstringEmail address
phonestringPhone number
sourcestringData source
source_urlstringURL where found
verifiedbooleanContact verification status
seniority_levelstringexecutive, senior, manager, staff
email_statusstringvalid, catch_all, pending, invalid
departmentstringDepartment/division
quality_scoreintegerQuality score (0-100)
confidencefloatConfidence score (0.0-1.0)
is_stalebooleanWhether contact data is outdated
is_speculativebooleanWhether contact is speculative
created_atstringCreation timestamp (ISO 8601)
updated_atstringLast update timestamp (ISO 8601)

Contact data availability varies by company. Not all companies have publicly listed contacts. Use quality scores and confidence metrics to filter for the most reliable data.

NACE Industry Codes

The contacts API supports filtering by NACE industry classification. See the NACE Codes Reference for a complete guide to using industry filters.

Common NACE sections:

  • C: Manufacturing
  • J: Information and Communication
  • K: Financial and Insurance Activities
  • M: Professional, Scientific and Technical Activities

Was this page helpful?