{"uid":"cap_logO47JcTMlzP9qKrQnib","slug":"agents-bytemine-ai-bytemine-bulk-contact-enrichment-46524e25","name":"Bytemine Bulk Contact Enrichment","description":"Enrich up to 100 contacts in a single synchronous request.","url":"https://agents.bytemine.ai/functions/v1/api-gateway/bulk-contact-enrich?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["contacts"],"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":"USD","priceDynamic":true,"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":"dynamic","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},{"kind":"dynamic","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-x402","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-10-29T12:36:38.895Z","isFirstParty":false,"canonicalSlug":"agents-bytemine-ai-bytemine-bulk-contact-enrichment-46524e25"}