### Get Usage Response Example Source: https://developer.moltsets.com/api-reference/account/get-usage This example demonstrates a successful response for a monthly usage query. It includes period details, credit balance, daily breakdowns, and overall totals. ```json { "results": { "period": "month", "start_date": "2026-04-01", "end_date": "2026-04-29", "credit_balance": 250, "days": [ { "date": "2026-04-16", "calls": 2, "credits": 0, "with_data": 2, "without_data": 0, "failed": 0 } ], "totals": { "calls": 2, "credits": 0, "with_data": 2, "without_data": 0, "failed": 0 } }, "status": "ok", "metadata": { "tokens_charged": 0, "tokens_remaining": "unlimited", "daily_results_remaining": 9876 } } ``` -------------------------------- ### Get Usage Request Example Source: https://developer.moltsets.com/api-reference/account/get-usage This example shows how to request usage data for the past month. The `period` parameter can be set to 'today', 'week', 'month', or 'billing_cycle'. ```yaml openapi: 3.1.0 info: title: MoltSets API version: 1.0.0 description: >- Identity resolution API. Resolve emails, LinkedIn profiles, IP addresses, and emails into enriched contact and company data. servers: - url: https://api.moltsets.com/api/v1/tools description: Production security: - bearerAuth: [] tags: - name: Search description: >- Search and filter company and business profiles by name, domain, industry, size, or revenue. - name: Get Valid Emails description: Resolve and enrich valid business and personal email addresses. - name: Get Carrier-Verified Mobile Phones description: Enrich carrier-verified mobile phone numbers. - name: Get Full Business Profile description: Resolve identifiers to full business profiles and company firmographics. - name: Get Ad Audience description: >- Resolve identifiers to hashed email (HEM) and mobile advertising IDs (MAIDs) for audience matching. - name: Get Company description: Resolve IP addresses to company data. - name: Account description: Account management tools. Free — do not consume credits. paths: /get_usage: post: tags: - Account summary: Get Usage description: >- Retrieve a detailed breakdown of your MoltSets API credit usage for a chosen time period — today, the past week, the past month, or the current billing cycle. Returns a day-by-day log of API calls made, credits consumed, successful lookups, empty results, and failed requests, along with period totals. Use this to track consumption trends, audit usage by day, or build internal usage dashboards. operationId: getUsage requestBody: required: true content: application/json: schema: type: object properties: period: type: string enum: - today - week - month - billing_cycle default: today description: Time window to report on. Defaults to `today`. example: period: month responses: '200': description: Success content: application/json: example: results: period: month start_date: '2026-04-01' end_date: '2026-04-29' credit_balance: 250 days: - date: '2026-04-16' calls: 2 credits: 0 with_data: 2 without_data: 0 failed: 0 totals: calls: 2 credits: 0 with_data: 2 without_data: 0 failed: 0 status: ok metadata: tokens_charged: 0 tokens_remaining: unlimited daily_results_remaining: 9876 '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorBadRequest' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorUnauthorized' '422': description: Invalid Input content: application/json: schema: $ref: '#/components/schemas/ErrorInvalidInput' '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ErrorRateLimit' components: schemas: ErrorBadRequest: type: object properties: error: type: string example: Bad Request message: type: string example: >- The server cannot process the request due to a client error (400 Bad Request). ErrorUnauthorized: type: object properties: error: type: string example: Unauthorized ``` -------------------------------- ### Example Tool Endpoints Source: https://developer.moltsets.com/getting-started/overview Examples of specific endpoint paths for different MoltSets tools. These are appended to the base URL to target a particular function. ```text POST https://api.moltsets.com/api/v1/tools/linkedin_to_best_email POST https://api.moltsets.com/api/v1/tools/ip_to_company POST https://api.moltsets.com/api/v1/tools/get_account ``` -------------------------------- ### Error Response Examples Source: https://developer.moltsets.com/api-reference/get-linkedin/email-to-linkedin Examples of common error responses from the API, including invalid input and rate limiting. ```json { "error": "Invalid Input", "message": "Message describing the nature of the invalid input." } ``` ```json { "error": "Too Many Requests", "message": "Rate limit exceeded. Maximum 100 requests per second." } ``` -------------------------------- ### Search Business Email by Name Response Example (Found) Source: https://developer.moltsets.com/api-reference/search/search-business-email-by-name This example shows a successful response when a business email and LinkedIn profile are found. It includes the email, LinkedIn URL, and metadata about token usage. ```json { "results": { "email": "john.smith@acme.com", "linkedin_url": "https://linkedin.com/in/john-smith-123" }, "status": "ok", "metadata": { "tokens_charged": 1, "tokens_remaining": "unlimited", "daily_results_remaining": 9876 } } ``` -------------------------------- ### Example Request Body for Search Business Profile by Name Source: https://developer.moltsets.com/api-reference/search/search-business-profile-by-name An example JSON request body for the search_business_profile_by_name endpoint. This demonstrates how to provide the name, company domain, and optionally include mobile phone lookup. ```json { "name": "John Smith", "company": "acme.com", "include_mobile_phone": true } ``` -------------------------------- ### Search Business Email by Name Request Example Source: https://developer.moltsets.com/api-reference/search/search-business-email-by-name This example demonstrates how to structure a JSON request to find a business email address using the person's full name and company domain. ```json { "name": "John Smith", "company": "acme.com" } ``` -------------------------------- ### Get Billing Source: https://developer.moltsets.com/api-reference/account/get-billing Retrieve your MoltSets billing details, including your current plan, subscription status, remaining credit balance, billing period start and end dates, and the credit cost for each available tool. Use this to monitor spend, confirm renewal dates, or display live billing information inside your own application. ```APIDOC ## POST /get_billing ### Description Retrieve your MoltSets billing details, including your current plan, subscription status, remaining credit balance, billing period start and end dates, and the credit cost for each available tool. ### Method POST ### Endpoint /get_billing ### Parameters #### Request Body - **(object)** - Required - No arguments required. Send an empty object. ### Request Example ```json {} ``` ### Response #### Success Response (200) - **results** (object) - Billing details. - **plan** (string) - The current subscription plan (free, starter, growth, unlimited). - **subscription_status** (string) - The current subscription status (active, none, cancelled, past_due). - **credit_balance** (integer) - The remaining credit balance. - **unlimited** (boolean) - Indicates if the plan is unlimited. - **current_period_start** (string or null) - The start date of the current billing period. - **current_period_end** (string or null) - The end date of the current billing period. - **token_costs** (object) - Credit cost per tool call. Keys are tool names, values are integer credit costs. - **status** (string) - The status of the response, typically 'ok'. - **metadata** (object) - Metadata about the request. #### Response Example ```json { "results": { "plan": "free", "subscription_status": "none", "credit_balance": 250, "unlimited": false, "current_period_start": null, "current_period_end": null, "token_costs": { "linkedin_to_best_email": 1, "linkedin_to_business_email": 1, "linkedin_to_personal_email": 1, "linkedin_to_mobile_phone": 10, "get_account": 0, "get_billing": 0, "get_usage": 0 } }, "status": "ok", "metadata": { "tokens_charged": 0, "tokens_remaining": "unlimited" } } ``` ``` -------------------------------- ### Example Success Response for Search Business Profile by Name Source: https://developer.moltsets.com/api-reference/search/search-business-profile-by-name An example JSON response when a business profile is successfully found using the search_business_profile_by_name endpoint. It includes the person's details, company information, firmographics, and metadata about token usage. ```json { "results": { "full_name": "John Smith", "first_name": "John", "last_name": "Smith", "title": "VP of Engineering", "company": "Acme Inc", "company_domain": "acme.com", "linkedin_url": "https://linkedin.com/in/john-smith-123", "mobile_phone": "+15551234567", "firmographics": { "industry": "Software", "employee_count": "201-500", "revenue": "$50M-$100M" } }, "status": "ok", "metadata": { "tokens_charged": 1, "tokens_remaining": "unlimited", "daily_results_remaining": 9876 } } ``` -------------------------------- ### LinkedIn to Best Personal Email API Request Example Source: https://developer.moltsets.com/api-reference/get-valid-emails/linkedin-to-best-personal-email This example demonstrates how to call the /linkedin_to_best_personal_email endpoint with a LinkedIn profile URL. Ensure you have the correct API key and endpoint URL. ```shell curl -X POST \ https://api.moltsets.com/api/v1/tools/linkedin_to_best_personal_email \ -H 'Authorization: Bearer YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ \ "linkedin_url": "https://linkedin.com/in/johndoe" \ }' ``` -------------------------------- ### Email to LinkedIn Response Example Source: https://developer.moltsets.com/api-reference/get-linkedin/email-to-linkedin A successful response contains the highest-confidence LinkedIn profile URL and metadata about token usage. This example shows a successful lookup. ```json { "results": { "linkedin_url": "https://www.linkedin.com/in/john-smith-123" }, "status": "ok", "metadata": { "tokens_charged": 1, "tokens_remaining": "unlimited", "daily_results_remaining": 9876 } } ``` -------------------------------- ### Email to MAID Request Example Source: https://developer.moltsets.com/api-reference/get-ad-audience/email-to-maid Send a POST request to the /email_to_maid endpoint with an email address in the request body to retrieve associated MAIDs. ```yaml openapi: 3.1.0 info: title: MoltSets API version: 1.0.0 description: >- Identity resolution API. Resolve emails, LinkedIn profiles, IP addresses, and emails into enriched contact and company data. servers: - url: https://api.moltsets.com/api/v1/tools description: Production security: - bearerAuth: [] tags: - name: Search description: >- Search and filter company and business profiles by name, domain, industry, size, or revenue. - name: Get Valid Emails description: Resolve and enrich valid business and personal email addresses. - name: Get Carrier-Verified Mobile Phones description: Enrich carrier-verified mobile phone numbers. - name: Get Full Business Profile description: Resolve identifiers to full business profiles and company firmographics. - name: Get Ad Audience description: >- Resolve identifiers to hashed email (HEM) and mobile advertising IDs (MAIDs) for audience matching. - name: Get Company description: Resolve IP addresses to company data. - name: Account description: Account management tools. Free — do not consume credits. paths: /email_to_maid: post: tags: - Get Ad Audience summary: Email to MAID description: >- Resolve an email address to one or more Mobile Advertising IDs (MAIDs), including AAIDs (Android Advertising IDs) and IDFAs (Apple Identifier for Advertisers). MAIDs are used by ad platforms to target users on their mobile devices with precision. Use this endpoint to connect a known email identity to mobile device signals — enabling cross-device retargeting, programmatic audience activation, and mobile-first ad campaigns against your contact lists. operationId: hemToMaid requestBody: required: true content: application/json: schema: type: object properties: email: type: string description: Email address. examples: email: summary: Using email value: email: john.smith@example.com responses: '200': description: Success content: application/json: examples: found: summary: Data found value: results: - device_id: b8c747bb-96c5-453f-b770-9d64889XXXXX device_type: AAID status: ok metadata: tokens_charged: 1 tokens_remaining: unlimited daily_results_remaining: 9876 '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorBadRequest' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorUnauthorized' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorNotFound' '422': description: Invalid Input content: application/json: schema: $ref: '#/components/schemas/ErrorInvalidInput' '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ErrorRateLimit' components: schemas: ErrorBadRequest: type: object properties: error: type: string example: Bad Request message: type: string example: >- The server cannot process the request due to a client error (400 Bad Request). ErrorUnauthorized: type: object properties: error: type: string example: Unauthorized message: type: string example: Invalid API key. ErrorNotFound: type: object properties: ``` -------------------------------- ### Get Account Source: https://developer.moltsets.com/getting-started/overview Retrieves account-specific information. ```APIDOC ## POST /tools/get_account ### Description Retrieves account-specific information. ### Method POST ### Endpoint https://api.moltsets.com/api/v1/tools/get_account ### Parameters #### Request Body - **account_id** (string) - Required - The ID of the account to retrieve. ### Request Example { "account_id": "acc_12345" } ### Response #### Success Response (200) - **results** (object) - The account information. May be an empty object if no data is found. - **status** (string) - Always "ok" on a successful request. - **metadata** (object) - Contains information about the API usage. - **tokens_charged** (integer) - Credits consumed by the request. - **tokens_remaining** (integer) - Remaining credit balance after the request. #### Response Example { "results": { "account_name": "Example Corp", "industry": "Technology" }, "status": "ok", "metadata": { "tokens_charged": 1, "tokens_remaining": 204 } } ``` -------------------------------- ### Email to LinkedIn Request Example Source: https://developer.moltsets.com/api-reference/get-linkedin/email-to-linkedin Send a POST request to the /email_to_linkedin endpoint with the email address in the request body. This example shows how to use a specific email address. ```yaml openapi: 3.1.0 info: title: MoltSets API version: 1.0.0 description: >- Identity resolution API. Resolve emails, LinkedIn profiles, IP addresses, and emails into enriched contact and company data. servers: - url: https://api.moltsets.com/api/v1/tools description: Production security: - bearerAuth: [] tags: - name: Search description: >- Search and filter company and business profiles by name, domain, industry, size, or revenue. - name: Get Valid Emails description: Resolve and enrich valid business and personal email addresses. - name: Get Carrier-Verified Mobile Phones description: Enrich carrier-verified mobile phone numbers. - name: Get Full Business Profile description: Resolve identifiers to full business profiles and company firmographics. - name: Get Ad Audience description: >- Resolve identifiers to hashed email (HEM) and mobile advertising IDs (MAIDs) for audience matching. - name: Get Company description: Resolve IP addresses to company data. - name: Account description: Account management tools. Free — do not consume credits. paths: /email_to_linkedin: post: tags: - Get LinkedIn summary: Email to LinkedIn description: >- Resolve an email address to the highest-confidence LinkedIn profile URL when multiple candidates exist. Unlike `hem_to_linkedin`, which returns a slug, this endpoint scores all matching profiles and returns the single best full LinkedIn URL. Use this when email-to-LinkedIn match quality is critical — for example, before personalising outreach, triggering enrichment workflows, or appending LinkedIn data to a contact record. operationId: hemToBestLinkedin requestBody: required: true content: application/json: schema: type: object properties: email: type: string description: Email address. examples: email: summary: Using email value: email: john.smith@example.com responses: '200': description: Success content: application/json: examples: found: summary: Data found value: results: linkedin_url: https://www.linkedin.com/in/john-smith-123 status: ok metadata: tokens_charged: 1 tokens_remaining: unlimited daily_results_remaining: 9876 '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorBadRequest' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorUnauthorized' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorNotFound' '422': description: Invalid Input content: application/json: schema: $ref: '#/components/schemas/ErrorInvalidInput' '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ErrorRateLimit' components: schemas: ErrorBadRequest: type: object properties: error: type: string example: Bad Request message: type: string example: >- The server cannot process the request due to a client error (400 Bad Request). ErrorUnauthorized: type: object properties: error: type: string example: Unauthorized message: type: string example: Invalid API key. ErrorNotFound: type: object properties: error: type: string example: Not Found ``` -------------------------------- ### Example Request Body Source: https://developer.moltsets.com/api-reference/get-ad-audience/business-email-to-sha256 This snippet shows the structure of a request body to convert a business email address to its SHA256 hash. Ensure the 'email' field contains the valid business email address. ```json { "email": "john.smith@example.com" } ``` -------------------------------- ### Email to MAID Success Response Example Source: https://developer.moltsets.com/api-reference/get-ad-audience/email-to-maid A successful response from the /email_to_maid endpoint, containing the resolved MAID (AAID in this case) and metadata about the request. ```json { "results": [ { "device_id": "b8c747bb-96c5-453f-b770-9d64889XXXXX", "device_type": "AAID" } ], "status": "ok", "metadata": { "tokens_charged": 1, "tokens_remaining": "unlimited", "daily_results_remaining": 9876 } } ``` -------------------------------- ### Get Account Details (OpenAPI Specification) Source: https://developer.moltsets.com/api-reference/account/get-account This OpenAPI specification defines the /get_account POST endpoint for retrieving MoltSets account details. It outlines the request body (an empty object) and the structure of the successful response, including account ID, name, status, plan, credit balance, and more. ```yaml openapi: 3.1.0 info: title: MoltSets API version: 1.0.0 description: >- Identity resolution API. Resolve emails, LinkedIn profiles, IP addresses, and emails into enriched contact and company data. servers: - url: https://api.moltsets.com/api/v1/tools description: Production security: - bearerAuth: [] tags: - name: Search description: >- Search and filter company and business profiles by name, domain, industry, size, or revenue. - name: Get Valid Emails description: Resolve and enrich valid business and personal email addresses. - name: Get Carrier-Verified Mobile Phones description: Enrich carrier-verified mobile phone numbers. - name: Get Full Business Profile description: Resolve identifiers to full business profiles and company firmographics. - name: Get Ad Audience description: >- Resolve identifiers to hashed email (HEM) and mobile advertising IDs (MAIDs) for audience matching. - name: Get Company description: Resolve IP addresses to company data. - name: Account description: Account management tools. Free — do not consume credits. paths: /get_account: post: tags: - Account summary: Get Account description: >- Retrieve your MoltSets account details, including account name, current plan, account status, remaining credit balance, number of API keys, and user count. Use this to programmatically check account health, verify active status, or display account information inside your own application or dashboard. operationId: getAccount requestBody: required: true content: application/json: schema: type: object description: No arguments required. Send an empty object. example: {} responses: '200': description: Success content: application/json: schema: type: object properties: results: type: object properties: id: type: string description: Account ID name: type: string description: Account name status: type: string description: Account status enum: - active - suspended plan: type: string description: Current plan enum: - free - starter - growth - unlimited credit_balance: type: integer description: Remaining credits unlimited: type: boolean description: true if the account has unlimited credits api_key_count: type: integer description: Number of API keys on the account user_count: type: integer description: Number of users on the account created_at: type: string format: date-time description: ISO 8601 account creation timestamp status: type: string example: ok metadata: $ref: '#/components/schemas/Metadata' example: results: id: '#######' name: Account_Name status: active plan: subscription_97 token_balance: -1 unlimited: true daily_result_limit: 15000 daily_results_used: 0 external_token_balance: 100 external_token_allowance: 500 external_tokens_purchased: 0 api_key_count: 2 user_count: 1 created_at: '2026-05-26T12:28:10Z' status: ok ``` -------------------------------- ### Get Billing Information Source: https://developer.moltsets.com/api-reference/account/get-billing Retrieves the current billing and usage status for the account. ```APIDOC ## GET /billing ### Description Retrieves the current billing and usage status for the account, including token consumption and daily result limits. ### Method GET ### Endpoint /billing ### Parameters #### Query Parameters - **fields** (string) - Optional - Comma-separated list of fields to return. Available fields: `tokens_charged`, `tokens_remaining`, `daily_results_remaining`. ### Request Example ```http GET /billing?fields=tokens_remaining,daily_results_remaining HTTP/1.1 Host: api.example.com Authorization: Bearer YOUR_API_KEY Accept: application/json ``` ### Response #### Success Response (200) - **tokens_charged** (integer) - Tokens consumed by this request. Always `0` when no data is returned. - **tokens_remaining** (string) - Tokens remaining after this request. Number if on the free plan, 'unlimited' if paid. - **daily_results_remaining** (integer) - The number of 'results' remaining on your daily rate limit. Daily rate limit is unique per plan. #### Response Example ```json { "tokens_charged": 10, "tokens_remaining": 9876, "daily_results_remaining": 5000 } ``` #### Error Responses - **400 Bad Request**: Returned when the request is malformed or invalid. - **401 Unauthorized**: Returned when the API key is invalid or missing. - **422 Invalid Input**: Returned when the input parameters are invalid. - **429 Rate limit exceeded**: Returned when the request rate limit has been exceeded. ``` -------------------------------- ### Example Success Response Source: https://developer.moltsets.com/api-reference/get-ad-audience/business-email-to-sha256 This snippet demonstrates a successful response containing the SHA256 hashed personal email address. The 'personal_email_SHA256' field holds the hashed value, which can be used for audience matching. ```json { "results": { "personal_email_SHA256": [ "e187e84b06e1e6577bcebe42d3905434ddc89d2d5abaab8e85691882310XXXXX" ] }, "status": "ok", "metadata": { "tokens_charged": 1, "tokens_remaining": "unlimited", "daily_results_remaining": 9876 } } ``` -------------------------------- ### Get Billing Information (OpenAPI) Source: https://developer.moltsets.com/api-reference/account/get-billing This OpenAPI specification defines the POST request to retrieve billing details. It requires an empty JSON object as the request body and returns detailed billing information upon success. ```yaml openapi: 3.1.0 info: title: MoltSets API version: 1.0.0 description: >- Identity resolution API. Resolve emails, LinkedIn profiles, IP addresses, and emails into enriched contact and company data. servers: - url: https://api.moltsets.com/api/v1/tools description: Production security: - bearerAuth: [] tags: - name: Search description: >- Search and filter company and business profiles by name, domain, industry, size, or revenue. - name: Get Valid Emails description: Resolve and enrich valid business and personal email addresses. - name: Get Carrier-Verified Mobile Phones description: Enrich carrier-verified mobile phone numbers. - name: Get Full Business Profile description: Resolve identifiers to full business profiles and company firmographics. - name: Get Ad Audience description: >- Resolve identifiers to hashed email (HEM) and mobile advertising IDs (MAIDs) for audience matching. - name: Get Company description: Resolve IP addresses to company data. - name: Account description: Account management tools. Free — do not consume credits. paths: /get_billing: post: tags: - Account summary: Get Billing description: >- Retrieve your MoltSets billing details, including your current plan, subscription status, remaining credit balance, billing period start and end dates, and the credit cost for each available tool. Use this to monitor spend, confirm renewal dates, or display live billing information inside your own application. operationId: getBilling requestBody: required: true content: application/json: schema: type: object description: No arguments required. Send an empty object. example: {} responses: '200': description: Success content: application/json: schema: type: object properties: results: type: object properties: plan: type: string enum: - free - starter - growth - unlimited subscription_status: type: string enum: - active - none - cancelled - past_due credit_balance: type: integer unlimited: type: boolean current_period_start: type: - string - 'null' format: date-time current_period_end: type: - string - 'null' format: date-time token_costs: type: object description: >- Credit cost per tool call. Keys are tool names, values are integer credit costs. additionalProperties: type: integer status: type: string example: ok metadata: $ref: '#/components/schemas/Metadata' example: | { "results": { "plan": "free", "subscription_status": "none", "credit_balance": 250, "unlimited": false, "current_period_start": null, "current_period_end": null, "token_costs": { "linkedin_to_best_email": 1, "linkedin_to_business_email": 1, "linkedin_to_personal_email": 1, "linkedin_to_mobile_phone": 10, "get_account": 0, "get_billing": 0, "get_usage": 0 } }, "status": "ok", "metadata": { "tokens_charged": 0, "tokens_remaining": "unlimited" } } ``` -------------------------------- ### Get Usage Source: https://developer.moltsets.com/api-reference/account/get-usage Retrieve a detailed breakdown of your MoltSets API credit usage for a chosen time period — today, the past week, the past month, or the current billing cycle. Returns a day-by-day log of API calls made, credits consumed, successful lookups, empty results, and failed requests, along with period totals. ```APIDOC ## POST /get_usage ### Description Retrieve a detailed breakdown of your MoltSets API credit usage for a chosen time period — today, the past week, the past month, or the current billing cycle. Returns a day-by-day log of API calls made, credits consumed, successful lookups, empty results, and failed requests, along with period totals. Use this to track consumption trends, audit usage by day, or build internal usage dashboards. ### Method POST ### Endpoint /get_usage ### Parameters #### Request Body - **period** (string) - Optional - Time window to report on. Defaults to `today`. Enum: `today`, `week`, `month`, `billing_cycle`. ### Request Example { "period": "month" } ### Response #### Success Response (200) - **results** (object) - Usage data for the specified period. - **period** (string) - The reporting period. - **start_date** (string) - The start date of the reporting period. - **end_date** (string) - The end date of the reporting period. - **credit_balance** (integer) - The remaining credit balance. - **days** (array) - An array of daily usage statistics. - **date** (string) - The date of the daily log. - **calls** (integer) - Number of API calls made on this day. - **credits** (integer) - Credits consumed on this day. - **with_data** (integer) - Number of successful lookups. - **without_data** (integer) - Number of empty results. - **failed** (integer) - Number of failed requests. - **totals** (object) - Summary totals for the period. - **calls** (integer) - Total API calls for the period. - **credits** (integer) - Total credits consumed for the period. - **with_data** (integer) - Total successful lookups for the period. - **without_data** (integer) - Total empty results for the period. - **failed** (integer) - Total failed requests for the period. - **status** (string) - The status of the request (e.g., 'ok'). - **metadata** (object) - Additional metadata about the account status. - **tokens_charged** (integer) - Tokens charged for the request. - **tokens_remaining** (string) - Remaining tokens (can be 'unlimited'). - **daily_results_remaining** (integer) - Daily results remaining. #### Response Example { "results": { "period": "month", "start_date": "2026-04-01", "end_date": "2026-04-29", "credit_balance": 250, "days": [ { "date": "2026-04-16", "calls": 2, "credits": 0, "with_data": 2, "without_data": 0, "failed": 0 } ], "totals": { "calls": 2, "credits": 0, "with_data": 2, "without_data": 0, "failed": 0 } }, "status": "ok", "metadata": { "tokens_charged": 0, "tokens_remaining": "unlimited", "daily_results_remaining": 9876 } } #### Error Response (400) Bad Request #### Error Response (401) Unauthorized #### Error Response (422) Invalid Input #### Error Response (429) Rate limit exceeded ``` -------------------------------- ### LinkedIn to Mobile Phone - Single Lookup Example Source: https://developer.moltsets.com/api-reference/get-carrier-verified-mobile-phones/linkedin-to-mobile-phone Use this example to find the mobile phone number for a single LinkedIn profile. Ensure you provide a valid `linkedin_url`. ```yaml openapi: 3.1.0 info: title: MoltSets API version: 1.0.0 description: >- Identity resolution API. Resolve emails, LinkedIn profiles, IP addresses, and emails into enriched contact and company data. servers: - url: https://api.moltsets.com/api/v1/tools description: Production security: - bearerAuth: [] tags: - name: Search description: >- Search and filter company and business profiles by name, domain, industry, size, or revenue. - name: Get Valid Emails description: Resolve and enrich valid business and personal email addresses. - name: Get Carrier-Verified Mobile Phones description: Enrich carrier-verified mobile phone numbers. - name: Get Full Business Profile description: Resolve identifiers to full business profiles and company firmographics. - name: Get Ad Audience description: >- Resolve identifiers to hashed email (HEM) and mobile advertising IDs (MAIDs) for audience matching. - name: Get Company description: Resolve IP addresses to company data. - name: Account description: Account management tools. Free — do not consume credits. paths: /linkedin_to_mobile_phone: post: tags: - Get Carrier-Verified Mobile Phones summary: LinkedIn to Mobile Phone description: >- Look up the carrier-verified mobile phone number for a LinkedIn profile. Only mobile numbers are returned — no landlines or VoIP numbers — so every result is a real device. Supports both single lookups (`linkedin_url`) and batch lookups of up to 100 profiles at once (`linkedin_urls`). Use for SMS outreach, cold calling, or enriching sales sequences with direct-dial mobile numbers. operationId: enrichPhone requestBody: required: true content: application/json: schema: type: object properties: linkedin_url: type: string description: Single LinkedIn profile URL. linkedin_urls: type: array items: type: string maxItems: 100 description: Batch of LinkedIn profile URLs, up to 100. examples: single: summary: Single lookup value: linkedin_url: https://linkedin.com/in/retentionadam batch: summary: Batch lookup value: linkedin_urls: - https://linkedin.com/in/retentionadam - https://linkedin.com/in/jane-doe responses: '200': description: Success content: application/json: examples: found: summary: Data found value: results: mobile_phone: '5555555555' status: ok metadata: tokens_charged: 10 tokens_remaining: unlimited daily_results_remaining: 9876 '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorBadRequest' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorUnauthorized' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorNotFound' '422': description: Invalid Input content: application/json: schema: $ref: '#/components/schemas/ErrorInvalidInput' '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ErrorRateLimit' components: schemas: ErrorBadRequest: type: object properties: error: type: string example: Bad Request message: type: string example: >- ``` -------------------------------- ### Retrieve Account Details Source: https://developer.moltsets.com/llms.txt Fetches your account details, including your current credit balance. This endpoint is free to use. ```bash curl -X POST "https://api.moltsets.com/v1/get_account" \ -H "Authorization: Bearer YOUR_API_KEY" ``` -------------------------------- ### HTTP Headers Configuration Source: https://developer.moltsets.com/integrations/clay Configure the Content-Type and Authorization headers for the HTTP API request in Clay. Replace YOUR_API_KEY with your MoltSets API key. ```text Content-Type: application/json Authorization: Bearer YOUR_API_KEY ``` -------------------------------- ### Making a POST Request with cURL Source: https://developer.moltsets.com/getting-started/overview Demonstrates how to make a POST request to the MoltSets API using cURL. Ensure you include the Authorization and Content-Type headers, along with the JSON payload. ```bash curl -X POST https://api.moltsets.com/api/v1/tools/linkedin_to_best_email \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"linkedin_url": "https://linkedin.com/in/retentionadam"}' ``` -------------------------------- ### Claude Desktop MCP Server Configuration Source: https://developer.moltsets.com/integrations/moltsets-mcp JSON configuration for adding MoltSets MCP server to Claude Desktop. Requires replacing placeholder values with your actual client ID and secret. ```json { "mcpServers": { "moltsets": { "type": "http", "url": "https://mcp.moltsets.com/mcp", "clientId": "your-client-id", "clientSecret": "your-client-secret" } } } ``` -------------------------------- ### POST /get_account Source: https://developer.moltsets.com/llms.txt Retrieves account details, including the current credit balance. This endpoint is free to use. ```APIDOC ## POST /get_account ### Description Retrieves account details, including the current credit balance. This endpoint is free to use. ### Method POST ### Endpoint /get_account ### Response #### Success Response (200) - **account_details** (object) - Details about the account. - **credit_balance** (integer) - The current credit balance. ``` -------------------------------- ### Making Authenticated API Request Source: https://developer.moltsets.com/getting-started/authentication Use curl to send a POST request to the get_account endpoint, including your API key as a Bearer token in the Authorization header. ```bash curl -X POST https://api.moltsets.com/api/v1/tools/get_account \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{}' ```