{"uid":"cap_logO47JcTMlzP9qKrQnib","slug":"agents-bytemine-ai-bytemine-bulk-contact-enrichment-46524e25","name":"Bytemine Bulk Contact Enrichment","description":"Bytemine is a B2B data platform for sales and go to market teams. It covers contact and company search across 135M professionals and 10M companies, contact and company enrichment, LinkedIn profile search and enrichment, live company intelligence read from a company's own web presence, technographics, buying intent scoring, and hiring, funding, job posting, and job change signals. Search results bill per record returned, enrichment bills only on a successful match, and count queries are free. This server is a pay-per-use, transparent proxy in front of Bytemine's own API: it handles identity, payment, and proxying. Agents can purchase autonomously or with their human's approval. This document is the source of truth for agents: it lists the complete verified paid surface with each operation's live price in its x-payment-info. Endpoints not listed here are not part of the supported catalog. The live catalog at /manifest.json is authoritative for prices and any free included units (prices[].includedUnits) - some meters include free usage per account before any charge, reserved for agents claimed by a human with a verified email.","url":"https://agents.bytemine.ai/functions/v1/api-gateway/bulk-contact-enrich","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"filters":{"type":"object","properties":{"hasPhone":{"type":"boolean"},"hasPhoneCell":{"type":"boolean"},"hasWorkEmail":{"type":"boolean"},"hasDirectDial":{"type":"boolean"},"hasLocalAddress":{"type":"boolean"},"hasPersonalEmail":{"type":"boolean"},"hasPrimaryContact":{"type":"boolean"}},"description":"Optional match filters applied to every contact. At least one must be true when provided."},"contacts":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string"},"phone":{"type":"string"},"lastName":{"type":"string"},"linkedin":{"type":"string"},"firstName":{"type":"string"},"companyDomain":{"type":"string"}}},"maxItems":100,"description":"Up to 100 contacts, each with at least one identifier."},"fullResponse":{"type":"boolean","description":"True returns complete profiles. False slims results to email and phone fields. Default true."}}},"responseSchema":{"type":"object","properties":{"total":{"type":"integer"},"failed":{"type":"integer"},"results":{"type":"array","items":{"type":"object","properties":{"data":{"type":"object"},"index":{"type":"integer"},"status":{"enum":["enriched","no_match","skipped","failed"],"type":"string"}}}},"skipped":{"type":"integer"},"enriched":{"type":"integer"},"no_match":{"type":"integer"},"processed":{"type":"integer"},"credits_used":{"type":"integer"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":{"amountUsd":"0.01","asset":"USDC"},"pricing":{"kind":"session","summary":"$0.01/call","primary":{"kind":"session","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact","depositUsd":"0.01"},"accepted":[{"kind":"session","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact","depositUsd":"0.01"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_h78V37TFo-A7rshwhnE4u","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"session","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":10000,"planRef":null},{"uid":"pm_0hZt6bmDwVxCsGRb2zT8D","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_4_FXG_Z52ncu8ge5M5xJY","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.bytemine.ai","brandSlug":"agents-bytemine-ai-mpp","brandBaseUrl":"https://agents.bytemine.ai","brandDocsUrl":null,"whatItDoes":"Enrich up to 100 contacts in a single synchronous call using email, LinkedIn, or phone as identifiers, returning full profiles or channel-only data; billed only on successful matches.","exampleAgentPrompt":"I have a list of 80 prospects — I've got their LinkedIn URLs and some emails — can you enrich all of them at once to get their work emails, direct dials, and phone numbers? Only return contacts that have at least a work email, and slim the response to contact channels only.","exampleUseCases":[{"title":"Sales list enrichment before outreach","prompt":"I've got 60 leads exported from LinkedIn — just names and LinkedIn URLs. Can you bulk-enrich them to pull their work emails and direct dial numbers? Only keep the ones that have a work email or phone, and just return the contact channel fields, not full profiles."},{"title":"CRM gap-fill for missing phone numbers","prompt":"We have 95 contacts in our CRM that are missing phone numbers — I have their work emails. Can you run them all through Bytemine's bulk contact enrichment and bring back whichever ones have a cell phone or direct dial on file?"},{"title":"Targeted outreach list building from mixed identifiers","prompt":"I have a mixed list of 40 contacts — some I only have email for, some just LinkedIn URLs, a few have phone numbers. Can you enrich all of them to get full profiles, and filter to only include people who have both a work email and a phone?"}],"resultDescription":"Returns a summary object with total, processed, enriched, no_match, skipped, and failed counts, plus a results array where each entry contains the original contact index, a status ('enriched', 'no_match', 'skipped', or 'failed'), and a data object with the enriched profile (full profile or contact-channel-only depending on fullResponse setting). Credits are only consumed for 'enriched' rows.","failureModes":["No identifier provided for a contact — row is skipped, no charge","No match found in Bytemine's database — status is no_match, no charge","Malformed email or LinkedIn URL — row fails, no charge","contacts array exceeds 100 items — request rejected","filters object provided but no filter key is true — request rejected","Network or upstream timeout — entire batch may return a failed status"],"whenToPreferThis":"Choose this endpoint when you need to enrich multiple contacts (2–100) in a single API call rather than making individual enrichment requests per contact. It is ideal for batch CRM enrichment, pre-campaign list hydration, and any workflow where you already have partial identifiers (email, LinkedIn, or phone) and need to fill in contact channels or full profiles at scale. Prefer single-contact enrichment when processing one lead at a time or when you need per-contact retry granularity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T04:07:13.563Z","isFirstParty":false}