canonical: https://jentic.com/apis/astrofabric.ai/astrofabric # AstroFabric API The AstroFabric API runs autonomous research and go-to-market agents that discover companies and people, enrich them with firmographic, technographic, and contact data, and track buying signals such as hiring, funding, and news. It verifies email deliverability in bulk, builds and scores prospect lists against an ideal customer profile, drafts personalized outbound, and pushes matched audiences to ad platforms. Webhook deliveries are HMAC-signed and retried with backoff so downstream systems receive every event at least once. ## For AI agents Discover and enrich companies and people, verify emails, track buying signals, score prospect lists, and push matched audiences to ad platforms. Authenticated with a bearer API key across 117 operations. ## Scope Does not handle payment processing, email sending, or CRM record storage beyond the connected upsert. Use for company and contact intelligence, enrichment, and audience building only. ## Capabilities - Discover companies by industry, size, technology, and buying-signal criteria - Enrich people and companies with contact details, firmographics, and technographic fingerprints - Verify email deliverability in bulk, up to 1,000 addresses per call - Track buying signals such as hiring, funding, and news for watched companies - Build, score, and clean prospect lists against an ideal customer profile - Draft personalized outbound and push matched audiences to LinkedIn, Meta, and Reddit ## Use cases ### Signal-Driven Prospecting A revenue team points an agent at AstroFabric to find companies currently in motion: those hiring, raising funding, or researching a topic. The agent discovers accounts by criteria, resolves the buying committee, and enriches each contact with a reachable email and phone before the list is handed to outreach. Example prompt: Call POST `/api/v1/tools/discover_companies` with industry and employee-range filters, then POST `/api/v1/tools/person_enrich` for each contact ### List Enrichment and Scoring An agent keeps a prospect list clean and ranked. It adds rows, enriches them with firmographic and technographic facts, scores each row against the workspace ideal customer profile, and runs hygiene to drop invalid emails and shared mailboxes before export. Example prompt: Call POST `/api/v1/tools/list_enrich` on a list, then POST `/api/v1/tools/list_score` to rank rows against the ICP ### Email Verification at Scale Before a send, an agent runs a batch of addresses through AstroFabric to filter undeliverable contacts. Bulk verification accepts up to 1,000 addresses in one call and returns a deliverability status for each, so the agent suppresses bad rows rather than burning sender reputation. Example prompt: Call POST `/api/v1/tools/email_verify` with up to 1,000 addresses and suppress the rows returned as undeliverable ### AI Agent Integration via Jentic An AI agent reaches AstroFabric through Jentic without wiring the bearer key or reading the reference for all 117 operations. It searches by intent, receives the matching tool and its input schema, and executes the call with the credential injected at run time, chaining discovery, enrichment, and outreach in one workflow. Example prompt: Search Jentic for 'enrich a company by domain', load the operation schema, and execute it with Jentic-managed credentials ## Key endpoints | Method | Path | Description | | --- | --- | --- | | POST | `/api/v1/tools/discover_companies` | Find companies matching criteria | | POST | `/api/v1/tools/company_lookup` | Look up companies by exact domain | | POST | `/api/v1/tools/person_enrich` | Enrich one person to a reachable record | | POST | `/api/v1/tools/email_verify` | Bulk email deliverability verification | | POST | `/api/v1/tools/find_email` | Find a person's work email | | GET | `/api/v1/lists` | List the workspace lists | | POST | `/api/v1/agents/prospecting` | Run the Prospecting Agent | | GET | `/api/v1/signals` | Read the buying-signal feed | ## Key resources - **Tools** — Discovery, enrichment, verification, and outreach tools under `/api/v1/tools` - **Agents** — Prebuilt prospecting, enrichment, audience, and signals agents under `/api/v1/agents` - **Lists** — Create, enrich, score, and export prospect lists under `/api/v1/lists` - **Signals** — Watch companies and read the buying-signal feed under `/api/v1/watches` and `/api/v1/signals` ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 55 / 100 - **Maturity:** Foundational - **Dimensions:** - Foundational Compliance: 47 / 100 - Developer Experience & Jentic Compatibility: 61 / 100 - AI-Readiness & Agent Experience: 45 / 100 - Agent Usability: 80 / 100 - Security: 60 / 100 - AI Discoverability: 47 / 100 - **View full report:** https://jentic.com/apis/astrofabric.ai/astrofabric/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring AstroFabric by hand means sending its bearer API key, verifying HMAC-signed webhook deliveries, and reading the reference for 117 operations yourself. Through Jentic you install once, import AstroFabric from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** AstroFabric puts the list id in the URL path (`/api/v1/lists/{id}`), so a rule can pin your agent to one list and the read or enrichment operations you pick. Destructive actions like list archive, audience execution, or conversion pushes are not included unless you add them. - **Credential handling:** Your AstroFabric key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'discover companies that are hiring' or 'verify a batch of emails', and Jentic returns the matching AstroFabric operation with its input schema so the agent calls the right tool without browsing the reference docs. ## Related APIs - **Apollo** — Sales intelligence and prospecting database with contact enrichment - **Clearbit** — Company and person enrichment from a single lookup - **People Data Labs** — Person and company datasets for bulk enrichment - **Hunter** — Email finder and verifier for a domain ## FAQ ### What authentication does the AstroFabric API use? The AstroFabric API authenticates with a bearer API key in the Authorization header per its OpenAPI spec, in the form Authorization: Bearer ek_live_. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at execution time, so it never reaches the agent's context. ### Can I verify email addresses in bulk with the AstroFabric API? Yes. The email verification tool accepts up to 1,000 addresses in one call and returns a deliverability status for each, so an agent can suppress undeliverable rows before a send. The results come back as structured JSON an agent can act on directly. ### Can I track buying signals for specific companies with the AstroFabric API? Yes. Register company domains with the watch tool, then read the signals feed to pull hiring, funding, news, and technology-change events for those companies. An agent can poll the feed on a cadence and react to new signals as they appear. ### How do I enrich a company through Jentic with the AstroFabric API? Search Jentic for 'enrich a company by domain', and it returns the AstroFabric company-lookup operation with its input schema. Load the schema and execute the call with the credential injected at run time. To run it on your own infrastructure, install Jentic One from its GitHub repo. ### Can I limit what my agent is allowed to do with the AstroFabric API? Yes. Write a rule that allows only the research and enrichment operations the agent needs, such as discovering companies and enriching contacts, while withholding write actions like pushing an audience to an ad platform or executing a conversion batch. Each call the agent makes runs through your own instance and is logged.