canonical: https://jentic.com/apis/powrbot.com/powrbot # Powrbot API The Powrbot API provides company data automation through single and bulk search capabilities. It returns firmographic data including revenue, founders, industry, founding year, headquarters, employee count, and website for any company name. Bulk searches accept CSV uploads with callback notifications and downloadable result files. ## For AI agents Look up company firmographic data including revenue, founders, industry, and employee count via single or bulk CSV searches. ## Scope Does not handle contact-level enrichment, email verification, or technographic data -- use for company firmographic lookups only. ## Capabilities - Look up company revenue, founders, and industry by name in a single request - Upload CSV files containing company names for batch enrichment - Track bulk search completion status and receive callback notifications - Download enriched company data as CSV for import into other systems - Retrieve historical search metadata including counts and timestamps ## Use cases ### Sales Lead Enrichment Enrich sales leads with company firmographic data by passing company names through the Powrbot single search endpoint. The API returns revenue, industry, employee count, and headquarters location, enabling sales teams to prioritize outreach based on company size and segment without manual research. Example prompt: Search for company 'Acme Corp' via GET `/search/single`/?company=Acme+Corp and extract revenue and employee count from the response ### Bulk Prospect List Enrichment Upload a CSV file containing hundreds of company names and receive enriched firmographic data for the entire list. Powrbot processes the batch asynchronously and sends a callback notification when complete. The enriched CSV includes revenue, founders, industry, and employee data for each company. Example prompt: Upload a CSV file with 50 company names via POST /search/ with a callback URL, then poll GET `/search/{searchId}` until is_completed is true, and download results via `/search/{searchId}/download` ### Competitive Intelligence Gathering Gather competitor data by searching for specific companies and extracting their revenue, founding year, and industry classification. The API pulls data from public sources to provide a snapshot of competitor positioning without requiring subscription to multiple data providers. Example prompt: Search for 'Competitor Inc' via GET `/search/single`/?company=Competitor+Inc and compare returned revenue and employee count against target benchmarks ### AI Agent Company Research via Jentic Enable AI agents to research companies on demand through Jentic by searching for company enrichment operations, loading the Powrbot schema, and executing lookups. Agents can answer user questions about company size, industry, or leadership without hardcoded API credentials. Example prompt: Search Jentic for 'look up company data by name', load the Powrbot search operation schema, and execute a single company lookup for the requested company ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/search/single/` | Search for a single company by name | | POST | `/search/single/` | Search for a single company via POST | | GET | `/search/` | List all previous searches with metadata | | POST | `/search/` | Create a bulk search from CSV upload | | GET | `/search/{searchId}` | Get status and results of a specific search | | GET | `/search/{searchId}/download` | Download search results as CSV | ## Key resources - **Single Search** — Look up one company at a time with immediate results - **Bulk Search** — CSV-based batch lookups with async processing and callbacks - **Search Results** — Status tracking and CSV download for completed searches ## 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:** 66 / 100 - **Maturity:** AI-Aware - **Dimensions:** - Foundational Compliance: 74 / 100 - Developer Experience & Jentic Compatibility: 63 / 100 - AI-Readiness & Agent Experience: 58 / 100 - Agent Usability: 94 / 100 - Security: 50 / 100 - AI Discoverability: 71 / 100 - **View full report:** https://jentic.com/apis/powrbot.com/powrbot/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 the Powrbot API by hand means formatting your secret key into the Authorization header as 'secret-key ' against powrbot.com/api/v1 and polling search ids for bulk results yourself. Through Jentic you install once, import the Powrbot API from the API Directory, store the API key once, and your agent calls it. - **Permission scoping:** Powrbot takes the company query in the request body or query string rather than as a path resource, so scoping is by operation: you limit the agent to the operations it needs, such as single company lookup or starting a bulk search. Downloading a completed search result is included only if you add that operation. - **Credential handling:** Your Powrbot secret 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 'look up company revenue' or 'run a bulk company search', and Jentic returns the matching Powrbot operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Clearbit API** — Broader company and contact enrichment with real-time data from more sources - **FullContact API** — Identity resolution and company enrichment with person-level matching - **Kickbox API** — Email verification service to validate contacts before outreach ## FAQ ### What authentication does the Powrbot API use? The Powrbot API uses API key authentication passed in the Authorization header with the format 'secret-key '. Through Jentic, this key is stored encrypted in the credential vault and agents receive scoped access without handling the raw secret. ### Can I search for multiple companies at once with the Powrbot API? Yes. The POST /search/ endpoint accepts a CSV file upload containing company names for bulk processing. You can include a callback_url parameter to receive a notification when the batch completes. Results are then available for download as CSV via the `/search/{searchId}/download` endpoint. ### What company data fields does Powrbot return? Powrbot returns company name, revenue, founders, industry, founding year, headquarters location, number of employees, and website URL. The data is sourced from public information including Wikipedia and other aggregated sources. ### What are the rate limits for the Powrbot API? Rate limits depend on your Powrbot subscription plan. The API returns standard HTTP 429 responses when limits are exceeded. Check your plan details at powrbot.com for specific request-per-minute allowances. ### How do I look up company data through Jentic? Install the Jentic SDK with pip install jentic, then search for 'look up company data by name'. Jentic returns the Powrbot GET `/search/single`/ operation with its schema. Pass the company name as the company query parameter to retrieve firmographic data. ### Can I limit what my agent is allowed to do with the Powrbot API? Yes. Because Powrbot takes the company name in the request body or query string rather than as a path resource, your self-hosted Jentic One instance scopes access by operation: your own rules decide which Powrbot operations the agent may call. You can allow only single company lookups, or add the bulk-search operation, and downloading a completed search result is available to the agent only if you include that operation. Jentic One injects your Powrbot secret key at execution time, so the agent runs only the operations you permit without ever seeing the raw key.