Bid analysis, by API.
Your product sends us competing contractor estimates. We send back the full graded comparison — neutral, third-party, machine-readable. One prepaid credit per report, no subscription.
Get an API key — $150 for 10 reportsPay by card; your key is emailed within a minute. Questions first? support@estimatehawk.com
Three calls, one report.
Submit estimates
POST 2–5 competing bids (PDFs or photos, up to 15 pages each) with your API key. One prepaid credit is used per report.
We extract, ground, grade
The same engine behind every EstimateHawk report: AI line-item extraction, market and reputation lookups where data exists, and a graded comparison.
Fetch the full report
Poll the report URL and get the complete analysis as JSON — scores, scope gaps, true-cost adjustments, questions to ask. Typically 1–3 minutes.
Submit, then fetch.
Three endpoints, standard bearer auth. Submissions return immediately with a report id; results are ready in one to three minutes; your balance and usage are one call away. Every error carries a stable machine-readable code. Machine-readable spec: OpenAPI.
curl -X POST \
https://estimatehawk.com/api/report \
-H "Authorization: Bearer eh_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"files": [
{ "name": "bid-a.pdf", "content_base64": "..." },
{ "name": "bid-b.pdf", "content_base64": "..." }
],
"project_type": "Roof Replacement",
"zip": "80210"
}'
# 202 Accepted
{
"report_id": "5f0c…",
"status": "processing",
"credits_remaining": 41,
"result_url": "https://estimatehawk.com/api/report?id=5f0c…"
}curl "https://estimatehawk.com/api/report?id=5f0c…" \
-H "Authorization: Bearer eh_live_YOUR_KEY"
# 200 OK (when finished)
{
"report_id": "5f0c…",
"status": "completed",
"report": {
"contractor_scores": [ … ],
"quick_insights": { … },
"risk_matrix": [ … ],
"overall_recommendation": "…",
"data_grounding": { … }
}
}curl "https://estimatehawk.com/api/report/account" \
-H "Authorization: Bearer eh_live_YOUR_KEY"
# 200 OK — the key is the account
{
"key": { "prefix": "eh_live_ab12cd3…", "daily_report_cap": 50, "created_at": "…" },
"credits_remaining": 41,
"usage": {
"today": 3,
"this_month": { "accepted": 9, "completed": 8, "failed": 1, "processing": 0 },
"all_time": { "accepted": 59, "completed": 57, "failed": 2, "processing": 0 },
"last_report_at": "2026-08-21T19:55:00Z"
}
}Same three calls, from Claude or ChatGPT.
A remote MCP server on EstimateHawk wraps submit, fetch, and account. Pass the same eh_live_… key as a Bearer token. EstimateHawk does not sell credits inside the chat — get a key on this page, then paste it into the connector.
MCP URL
https://estimatehawk.com/mcp
Claude
In Claude, open custom connectors and add a connector. Server URL: https://estimatehawk.com/mcp. Auth: Bearer / API key, value eh_live_…. After it connects, the tools are submit_bids, get_report, and get_account.
ChatGPT
With Developer Mode on, create a custom connector. MCP server URL: https://estimatehawk.com/mcp. Authentication: Bearer token, same API key. Same three tools; checkout stays on this page, not in the chat.
HTTP spec: /api/openapi.json. Direct functions URL still works if you already call it.
What comes back.
- A graded score (A–F) per contractor with plain-language reasoning
- Scope gaps with estimated dollar impact, weighted by criticality
- True-cost adjustment: quoted price + missing scope + risk contingency
- Market and reputation scores grounded in real lookups — or an explicit "insufficient data", never an invented number
- Risk matrix, negotiation questions, and an overall recommendation
- Machine-readable JSON you can render inside your own product
Prepaid credits. Nothing recurring.
One credit per delivered report. Credits never expire, failed reports refund themselves, and there is no platform fee.
How we handle your data.
Who sees your files
Your files are processed by an enterprise AI model provider under commercial terms that prohibit training on your data. Contractor names found in a bid are checked against a public business-review data service. Data may be processed in the United States. No other third party receives your files, and nothing is shared with contractors or insurers.
Failed reports refund themselves
You are only charged for delivered reports. If a report fails on our side for any reason, the credit returns to your balance automatically. Credit packs are prepaid and non-refundable; credits never expire.
Uploads are transient
Submitted files are deleted the moment processing finishes — on success or failure. Finished reports are available for 90 days, then deleted; only the billing record (report id, status, cost) is kept for accounting. We may use line-item pricing in anonymized, aggregated form to improve market benchmarks — never tied to you, your customers, or a contractor.
Use of the API is governed by our Terms of Service and Privacy Policy. Files are encrypted in transit and at rest, API keys are stored only as hashes, and a report can be read only by the key that created it. A full sub-processor list is available on request for customers with a data-processing agreement. Reports are decision support, not professional estimating, legal, or insurance advice.
Asked and answered.
Who is the report API for?
Platforms that already sit next to someone comparing contractor bids: realtor and home-buying tools, property-management software, home-warranty triage, renovation lending, and AI-agent workflows that need a bid-review step.
How do I get an API key?
Buy any credit pack with a card. Your key is emailed to the address you use at checkout within a minute of payment, with the credits already on it. Top-ups use the same links: buy with the same email and the credits land on your existing key automatically. Questions before buying? Email support@estimatehawk.com.
How is it priced?
Prepaid credit packs: 10 reports for $150, 100 for $1,200, or 500 for $4,500. One credit per delivered report, no subscription, no expiry on credits. Packs are prepaid and non-refundable; a report that fails on our side returns its credit automatically.
What files can I submit?
PDF estimates (up to 15 pages and 10MB each) and photographed quotes as JPG, PNG, or WebP (up to 5MB each). Between 2 and 5 estimates per report.
Do you sell or share the data we send?
No. Uploads are deleted after processing and reports are deleted after 90 days. Files are processed by an enterprise AI model provider that does not train on your data and a public business-review data service, and may be processed in the United States. The only reuse we reserve is anonymized, aggregated pricing benchmarks — never identifiable, never shared with contractors or insurers. Full details are in our Privacy Policy at estimatehawk.com/privacy/.
Is there a rate limit?
Each key has a daily report cap (50 by default — ask to raise it) and the platform has a global daily processing ceiling. Requests over the cap are refused before any credit is used.
Key emailed within a minute of payment · questions: support@estimatehawk.com