{ "openapi": "3.1.0", "x-zeroclick-navigation": { "fullSpec": "https://agents.bytemine.ai/zcj/z1aqdugeqrj8/openapi.json", "services": "https://agents.bytemine.ai/zcj/z1aqdugeqrj8/services", "serviceSpecTemplate": "https://agents.bytemine.ai/zcj/z1aqdugeqrj8/services/{slug}/openapi.json", "searchTemplate": "https://agents.bytemine.ai/zcj/z1aqdugeqrj8/openapi.json?q={text}", "operationTemplate": "https://agents.bytemine.ai/zcj/z1aqdugeqrj8/openapi.json?path={path}&method={method}", "firstPage": "https://agents.bytemine.ai/zcj/z1aqdugeqrj8/openapi.json?page=1", "instructions": [ "Use this spec if it contains the operation and details you need. Otherwise, search or open a relevant service spec using the links below.", "Find service slugs in x-zeroclick-services or x-payment-info.rates[].service; use them in serviceSpecTemplate, never as request values.", "URL-encode template values. Search is ranked; service, path, and method filters are exact. Filters combine.", "Pages contain up to 10 operations; follow info.x-next or the Link header if you need more results. Shared operations retain all selector values." ] }, "info": { "title": "Bytemine", "version": "1.0.0", "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. The complete verified paid surface is listed at /openapi.json, the source of truth for available operations. Each operation here carries its live price in x-payment-info. Use the operations and details here when they meet your needs. Filtered specs contain only matching operations; if you cannot find what you need here, use search or the service 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.", "x-guidance": "This is a filtered API reference. Request and response schemas are preserved. Shared operations retain selector values and prices for all their services; service slugs are pricing labels, never request values. If this spec lacks what you need, use the navigation links to search or open a relevant service spec." }, "x-service-info": { "categories": [ "data" ], "docs": { "homepage": "https://www.bytemine.ai", "apiReference": "https://agents.bytemine.ai/zcj/z1aqdugeqrj8/openapi.json", "llms": "https://agents.bytemine.ai/zcj/z1aqdugeqrj8/llms.txt" } }, "externalDocs": { "url": "https://agents.bytemine.ai/zcj/z1aqdugeqrj8/llms-full.txt", "description": "How to authenticate, pay, and call this API; links the upstream API reference." }, "servers": [ { "url": "https://agents.bytemine.ai/zcj/z1aqdugeqrj8", "description": "Pay-per-use access to Bytemine's API" } ], "security": [ { "payPerUse": [] } ], "components": { "securitySchemes": { "payPerUse": { "type": "apiKey", "in": "header", "name": "x-payment", "description": "Pay-per-use access. An unpaid call returns 402 Payment Required with a signed challenge; settle it with a supported payment method (x402 or MPP today) and retry with the proof in this header (x402) or as Authorization: Payment (MPP; use ZC-Agent-Authorization for a separate buyer bearer). No upstream API key is needed, and an agent without a payment method can set one up instantly at no cost." }, "sellerAgentX402": { "type": "apiKey", "in": "header", "name": "Payment-Signature", "description": "Signed $0 x402 proof from the 402 challenge" }, "sellerAgentMpp": { "type": "http", "scheme": "Payment", "description": "Signed $0 MPP proof from the 402 challenge" } } }, "paths": { "/functions/v1/api-gateway/bulk-contact-enrich": { "post": { "summary": "Bulk Enrich Contacts", "responses": { "200": { "content": { "application/json": { "schema": { "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" } } } } }, "description": "Successful response" }, "402": { "description": "Payment required" } }, "description": "Enrich up to 100 contacts in a single synchronous request.", "operationId": "bulkEnrichContacts", "requestBody": { "content": { "application/json": { "schema": { "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." } } } } }, "required": true }, "x-zeroclick-document-sources": [ { "gaps": [ "Missing response schema details" ], "pages": [ 10 ], "sourceId": "sds_425e1f89515593750938407ec1dee054", "authority": "supplemental", "conflicts": [ "/responses/200/description" ], "revisionId": "sdrn_5vgef_1pPqxWWIz2ub1my" } ], "x-zeroclick-services": [ "contact-enrichment" ], "x-payment-info": { "access": "payg", "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": null, "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.010000 per match (contact_match, service contact-enrichment)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "dynamic", "currency": "USD", "min": "0.010000" }, "rates": [ { "service": "contact-enrichment", "meter": "contact_match", "unit": "match", "unitSize": 1, "priceUsd": "0.010000", "includedUnits": 0 } ] } } }, "/functions/v1/api-gateway/contacts/enrich": { "post": { "summary": "Enrich Contact", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "pid": { "type": "string" }, "education": { "type": "array", "items": { "type": "object" } }, "full_name": { "type": "string" }, "job_title": { "type": "string" }, "seniority": { "type": "string" }, "department": { "type": "string" }, "work_email": { "type": "string" }, "company_name": { "type": "string" }, "company_domain": { "type": "string" }, "personal_email": { "type": "string" }, "work_experience": { "type": "array", "items": { "type": "object" } }, "company_industry": { "type": "string" }, "linkedin_profile": { "type": "string" }, "company_revenue_range": { "type": "string" }, "company_employee_range": { "type": "string" } } } } } } }, "description": "Successful response" }, "402": { "description": "Payment required" } }, "description": "Look up and enrich a single contact.", "operationId": "enrichContact", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "description": "Email address to look up." }, "phone": { "type": "string", "description": "Phone number to look up." }, "facebook": { "type": "string", "description": "Facebook profile URL." }, "hasPhone": { "type": "boolean" }, "lastName": { "type": "string" }, "linkedin": { "type": "string", "description": "LinkedIn profile URL to look up." }, "firstName": { "type": "string" }, "companyName": { "type": "string" }, "hasPhoneCell": { "type": "boolean" }, "hasWorkEmail": { "type": "boolean", "description": "Request work email in results." }, "companyDomain": { "type": "string" }, "hasDirectDial": { "type": "boolean" }, "hasLocalAddress": { "type": "boolean" }, "hasPersonalEmail": { "type": "boolean", "description": "Request personal email in results." }, "hasPrimaryContact": { "type": "boolean" } } } } }, "required": true }, "x-zeroclick-document-sources": [ { "gaps": [ "Missing response schema details" ], "pages": [ 9 ], "sourceId": "sds_425e1f89515593750938407ec1dee054", "authority": "supplemental", "conflicts": [ "/responses/200/description" ], "revisionId": "sdrn_5vgef_1pPqxWWIz2ub1my" }, { "gaps": [ "Missing request body schema", "Missing response schema" ], "pages": [ 7 ], "sourceId": "sds_FKPrTFrj3DPUtbSW8WoQ_", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description", "/operationId" ], "revisionId": "sdrn_KS5mL5dkS47dn7drWy2RQ" } ], "x-zeroclick-services": [ "contact-enrichment" ], "x-payment-info": { "access": "payg", "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": null, "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.010000 per match (contact_match, service contact-enrichment)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "dynamic", "currency": "USD", "min": "0.010000" }, "rates": [ { "service": "contact-enrichment", "meter": "contact_match", "unit": "match", "unitSize": 1, "priceUsd": "0.010000", "includedUnits": 0 } ] } } } }, "x-zeroclick-navigation-footer": { "instructions": [ "Use this spec if it contains the operation and details you need. Otherwise, search or open a relevant service spec using the links below.", "Find service slugs in x-zeroclick-services or x-payment-info.rates[].service; use them in serviceSpecTemplate, never as request values.", "URL-encode template values. Search is ranked; service, path, and method filters are exact. Filters combine.", "Pages contain up to 10 operations; follow info.x-next or the Link header if you need more results. Shared operations retain all selector values." ], "fullSpec": "https://agents.bytemine.ai/zcj/z1aqdugeqrj8/openapi.json", "services": "https://agents.bytemine.ai/zcj/z1aqdugeqrj8/services", "serviceSpecTemplate": "https://agents.bytemine.ai/zcj/z1aqdugeqrj8/services/{slug}/openapi.json", "searchTemplate": "https://agents.bytemine.ai/zcj/z1aqdugeqrj8/openapi.json?q={text}", "operationTemplate": "https://agents.bytemine.ai/zcj/z1aqdugeqrj8/openapi.json?path={path}&method={method}", "firstPage": "https://agents.bytemine.ai/zcj/z1aqdugeqrj8/openapi.json?page=1" } }