{"uid":"cap_udBrrsy5BGMB73QeGd0XT","slug":"agents-bytemine-ai-icp-builder-build-ideal-customer-profile-from-5bf41cf8","name":"ICP Builder — Build Ideal Customer Profile from Description","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/v1/icp-builder","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"count":{"type":"integer","description":"Matching companies to return. Default 50, max 200."},"description":{"type":"string","description":"Plain text description of the ideal customer profile."},"webhook_url":{"type":"string","description":"Optional URL that receives results when the job completes."}}},"responseSchema":{"type":"object","properties":{"job_id":{"type":"string"},"status":{"enum":["pending","processing","completed","failed"],"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"website":{"type":"string"},"industry":{"type":"string"},"company_id":{"type":"string"},"match_score":{"type":"number"},"employee_count":{"type":"integer"}}}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","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":null,"pricing":{"kind":"static","summary":"$0.5/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.5","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VViEKEBP_sZFI0RTxxkj7","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"usd","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_eCHLw_i151B5D8mxnCV0s","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.bytemine.ai","brandSlug":"agents-bytemine-ai-mpp","brandBaseUrl":"https://agents.bytemine.ai","brandDocsUrl":null,"whatItDoes":"Takes a plain-text description of an ideal customer profile and asynchronously returns a ranked list of matching companies with industry, size, and match score.","exampleAgentPrompt":"Build me an ICP from this description and return up to 100 matching companies: 'mid-market SaaS companies in the US with 100–500 employees, using Salesforce, and focused on B2B sales enablement.' Send results to https://hooks.myteam.com/icp-results when done.","exampleUseCases":[{"title":"Sales team target account list","prompt":"I need a list of 150 companies that match our ideal customer — fast-growing fintech startups in North America with 50 to 300 employees that are actively hiring sales reps. Send the results to https://hooks.acme.com/icp when ready."},{"title":"GTM launch prospect discovery","prompt":"We're launching a new product for e-commerce brands doing over $10M in revenue that use Shopify and have a dedicated marketing team. Can you build an ICP and find up to 200 matching companies for our go-to-market push?"},{"title":"Investor portfolio target sourcing","prompt":"Find me up to 100 companies that fit this profile: B2B software companies in the HR tech or workforce management space, 200–1000 employees, headquartered in Europe. Use this webhook to deliver results: https://signals.vc/icp-hook."}],"resultDescription":"Returns immediately with a job_id and status (pending/processing/completed/failed). When the job completes, the results array contains matching companies each with name, website, industry, company_id, employee_count, and a match_score (0–1) indicating fit against the provided ICP description. Results are delivered to the webhook_url if provided, or retrievable by polling the async job status endpoint.","failureModes":["Empty or vague description yields low-quality or zero matches","Requested count exceeds maximum of 200, causing a validation error","Webhook URL is unreachable, causing silent delivery failure — caller must poll instead","Job may remain in processing state if upstream data pipeline is slow or overloaded","Invalid webhook_url format causes immediate rejection","Flat-rate charge applies even if no matching companies are found"],"whenToPreferThis":"Choose this endpoint when you need to discover a fresh list of target companies from a written description of your ideal buyer, rather than searching by explicit filters. It is especially suited for early-stage GTM planning, account-based marketing list building, or when your ICP is best expressed in natural language rather than structured attributes. Prefer it over the lookalike endpoint when you don't already have example companies and want the AI to interpret the profile from scratch. Use the async job architecture for large batches (up to 200 results).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:04:21.437Z","isFirstParty":false}