--- title: MoltSets API Integration on Truto slug: moltsets category: Sales Intelligence canonical: "https://truto.one/integrations/detail/moltsets/" --- # MoltSets API Integration on Truto **Category:** Sales Intelligence **Status:** Beta ## Unified APIs ### Unified Enrichment API - **Company** — Represents a company as known to a sales intelligence or data enrichment provider: who it is, what it does, how big it is and where it is. A provider fills only the fields it has data for and omits the rest. - **Person** — Represents a person as known to a sales intelligence or data enrichment provider: who they are, their current job and how to contact them. A provider fills only the fields it has data for and omits the rest. ## MCP-ready AI tools Truto exposes 20 tools for MoltSets that AI agents can call directly. - **list_all_molt_sets_search_people** — Search the MoltSets people database by name, title, employer, seniority, department, industry, company size or location. Returns ranked profiles with business email and company. Needs at least one positive filter. Max 25 per page. 1 search record per row returned. - **list_all_molt_sets_search_companies** — Search the MoltSets company database by name, domain, industry, headcount, revenue, NAICS code or location. Returns ranked company profiles. Needs at least one positive filter. Max 25 per page. 1 search record per row returned. - **molt_sets_linkedin_profiles_search** — Find LinkedIn profiles that match a person's name and company domain. Set `count_only` to true to get only the match count, free, before spending a token. Costs 1 token when data is found; a `not_found` miss is free. - **molt_sets_linkedin_profiles_lookup_by_email** — Find the best-matching LinkedIn profile URL for an email address. Costs 1 token when data is found; a `not_found` miss is free. - **molt_sets_business_emails_search** — Find a person's verified work email from their name and company domain, with the matched LinkedIn URL and a send-safety `risk_score`. Costs 1 token when data is found; a `not_found` miss is free. - **molt_sets_business_profiles_search** — Find a person's business profile (job title, employer, firmographics) from their name and company domain. Costs 1 token when data is found; a `not_found` miss is free. - **molt_sets_business_profiles_lookup_by_email** — Get the business profile behind an email address: name, title, seniority, employer, LinkedIn URL, firmographics and other emails on file. Costs 1 token when data is found; a `not_found` miss is free. - **molt_sets_business_profiles_lookup_by_linkedin** — Get the most complete profile for a LinkedIn URL: name, title, location, employer firmographics, and business and personal emails with risk scores. Costs 1 token when data is found; a `not_found` miss is free. - **molt_sets_emails_lookup_best_by_linkedin** — Get the best email for a LinkedIn profile: a business email when one exists, else a personal one (`type` says which). Pass `linkedin_url`, or `linkedin_urls` for up to 100 profiles. Costs 1 token per profile found. - **molt_sets_emails_lookup_business_by_linkedin** — Get the verified work email for a LinkedIn profile (business addresses only). Pass `linkedin_url`, or `linkedin_urls` for up to 100 profiles. Costs 1 token per profile found. - **molt_sets_emails_lookup_personal_usa_by_linkedin** — Get a verified personal email (Gmail, iCloud and similar) for a LinkedIn profile. US records only, and not on every plan: check `personal_email_available` in the account details first (otherwise 403 `plan_restricted`). Pass `linkedin_url`, or `linkedin_urls` for up to 100 profiles. Costs 1 token per profile found. - **molt_sets_emails_lookup_best_personal_usa_by_linkedin** — Get the single highest-confidence personal email for a LinkedIn profile, with its last validation date. US records only, and not on every plan: check `personal_email_available` in the account details first (otherwise 403 `plan_restricted`). Pass `linkedin_url`, or `linkedin_urls` for up to 100 profiles. Costs 1 token per profile found. - **molt_sets_mobile_phones_lookup_by_linkedin** — Get a carrier-verified mobile number for a LinkedIn profile (mobiles only; not screened against Do Not Call lists). Pass `linkedin_url`, or `linkedin_urls` for up to 100 profiles. Spends 1 phone token per number returned, from a separate paid phone-token subscription; misses are free. - **molt_sets_ad_audiences_lookup_maid_by_email** — Get a mobile advertising ID (AAID or IDFA) for an email address, for mobile ad retargeting. Not available on the $397 and $997 plans (403 `plan_restricted`). Costs 1 token when data is found; a `not_found` miss is free. - **molt_sets_ad_audiences_lookup_sha_256_by_business_email** — Get the SHA256 hash of the personal email linked to a business email, for ad-platform customer match. Not available on the $397 and $997 plans (403 `plan_restricted`). Costs 1 token when data is found; a `not_found` miss is free. - **molt_sets_ad_audiences_lookup_hashes_by_linkedin** — Get SHA256 and MD5 hashes of the business and personal emails for a LinkedIn profile, for ad-platform customer match. Hashes with no data are left out. Not available on the $397 and $997 plans (403 `plan_restricted`). Costs 1 token when data is found; a `not_found` miss is free. - **molt_sets_companies_lookup_by_ip** — Identify the company domain(s) behind an IPv4 address, for B2B website-visitor identification. Consumer ISP addresses usually return nothing. Costs 1 token when data is found; a `not_found` miss is free. - **list_all_molt_sets_account** — Get your MoltSets account: plan, status, token and phone-token balances, live fair-use headroom, and whether personal-email lookups are on your plan. Free. - **list_all_molt_sets_billing** — Get your MoltSets billing details: plan, subscription status, token balance, billing period dates, and the token cost of each tool. Free. - **list_all_molt_sets_usage** — Get day-by-day MoltSets usage (calls, tokens, hits, misses, failures) with totals for today, the past week, the past month or the billing cycle. Free. ## How it works 1. **Link your customer's MoltSets account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach MoltSets.** The Proxy API is a 1-to-1 mapping of the MoltSets API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Embed Waterfall Contact Enrichment in Your Sales Platform** — Let your users enrich prospects with business emails, personal emails, and mobile numbers in a cost-controlled waterfall. Truto handles the MoltSets auth, token tracking, and fallback chains so you can ship a native enrichment feature without managing per-hit billing logic yourself. - **De-anonymize Website Visitors for Your Customers** — If you build visitor tracking, revenue intelligence, or ABM software, use MoltSets via Truto to turn IP addresses into company domains and then into named decision-makers. Your end users connect their own MoltSets account and bring their own tokens. - **Bridge B2B Lists into B2C Ad Audiences** — Marketing automation and ABM platforms can offer a one-click sync that converts business contacts into hashed personal emails and Mobile Advertising IDs for Meta, Google, and LinkedIn custom audiences — dramatically improving match rates for B2B retargeting. - **Power Passive Candidate Outreach in Recruiting Tools** — ATS and recruiting CRM vendors can embed MoltSets to pull personal emails and carrier-verified mobile numbers for passive candidates, since corporate emails rarely get responses to recruitment pitches. - **Offer Plan-Aware Enrichment UX** — Use MoltSets account and usage endpoints via Truto to detect each customer's plan tier and token balance, then selectively enable premium features (US personal emails, ad hashes, mobile numbers) in your UI — avoiding 403 plan_restricted errors for your end users. ## What you can build - **1-Click LinkedIn-to-CRM Prospect Capture** — Capture a LinkedIn URL from a browser extension and auto-create a contact with verified business email, firmographics, and risk score using business profile and email lookups by LinkedIn. - **IP-to-Lead Routing Workflow** — Translate anonymous site visitors into named leads by chaining company lookup by IP with people search at the identified domain, then push results into Slack or your CRM. - **Ad Audience Sync Connector** — Convert customer-uploaded business email lists into SHA-256 personal email hashes and MAIDs, ready to push into Meta, Google, and LinkedIn custom audience APIs. - **Reveal Mobile Number Button** — Expose carrier-verified mobile phone lookups as an explicit, user-triggered action — segregated from bulk enrichment so your users control their mobile phone subscription spend. - **Token Budget & Usage Dashboard** — Surface each customer's MoltSets plan tier, remaining tokens, and usage trends inside your product using the account, billing, and usage endpoints. - **Bulk Candidate Enrichment Pipeline** — Accept up to 100 LinkedIn URLs at once and return personal US emails and mobile numbers in a single job, built for recruiting and sourcing workflows. ## FAQs ### How do end users authenticate their MoltSets account? Your users connect their own MoltSets account through Truto's managed auth flow. Truto stores and refreshes the credentials, so you never handle API keys directly and don't need to build a settings page for them. ### How does billing work when my customers use MoltSets through my product? MoltSets uses a pay-per-hit token model where failed lookups are free. Each customer's calls draw from their own MoltSets token balance, which you can monitor via the list_all_molt_sets_billing and list_all_molt_sets_usage endpoints exposed through Truto. ### Can I handle plan-restricted features gracefully? Yes. Call list_all_molt_sets_account via Truto to detect the customer's plan tier before exposing premium features like US personal email lookups, ad audience hashes, or mobile phone reveals. This prevents 403 plan_restricted errors from reaching your UI. ### Does Truto normalize MoltSets data with other enrichment providers? Yes. MoltSets person and company endpoints are mapped to Truto's Unified Enrichment API (Company and Person), so you can swap or combine providers behind a single schema without changing your integration code. ### Can I run bulk LinkedIn enrichment jobs? Yes. The LinkedIn-based email and hash lookup endpoints accept up to 100 LinkedIn URLs per call, making them suitable for bulk sourcing and audience-building workflows. ### How do I avoid wasting tokens on low-quality matches? MoltSets returns a risk_score on business email searches and distinguishes carrier-verified mobile numbers from VoIP. You can also use count-only searches on LinkedIn profiles to confirm a match exists before spending a token on the full fetch.