Back to Browse
ICP Builder — Build Ideal Customer Profile from Description
x402
ICP Builder — Build Ideal Customer Profile from Description is a paid API for AI agents from agents.bytemine.ai, paid per call via MPP or x402, $0.5/call, status unknown (last checked 2026-10-29).
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.
Price / call$0.5
Success—
StatusUnknown
How this service works
Describe your ideal customer profile in plain text.
Output
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.
Example use cases
Sales team target account list
“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.”
GTM launch prospect discovery
“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?”
Investor portfolio target sourcing
“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.”
Technical details
Endpoint
POSThttps://agents.bytemine.ai/functions/v1/api-gateway/v1/icp-builder?utm_source=zero.xyzWhen to prefer
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).
Side effects
- 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
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| count | integer | Matching companies to return. Default 50, max 200. |
| descriptionrequired | string | Plain text description of the ideal customer profile. |
| webhook_url | string | Optional URL that receives results when the job completes. |
Output
Schema · Response
| Field | Type | Description |
|---|---|---|
| job_id | string | |
| status | string | |
| results | array |
Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"