hailpoint.com APIhailpoint.com ↗
Access historical hail maps, storm impact data, damage categories, and hail report markers by location, state, city, or date range via the Hail Point API.
curl -X GET 'https://api.parse.bot/scraper/a31237b8-4777-49ae-acf9-c3a25a0801e7/search_hail_maps?state=TX&keyword=Houston' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for hail maps/events by keyword (city/state/ZIP), state code, category, and date range. Returns paginated results sorted by date with up to 15 items per page.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| state | string | Two-letter US state code (e.g. TX, IN) or 'can' for Canada. |
| date_to | string | End date in YYYY-MM-DD format. |
| keyword | string | City, State, or ZIP code to search near. |
| category | string | Damage category filter. Accepted values: scattered, major, severe, catastrophic. |
| distance | integer | Search radius in miles from keyword location. |
| date_from | string | Start date in YYYY-MM-DD format. |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"count": "integer, number of items on this page",
"items": "array of hail map event summaries with detail_url, id, thumbnail_url, title, category, hail_size, location, date, population_impacted, homes_impacted",
"total_records": "string or null, total number of matching records"
},
"sample": {
"data": {
"page": 1,
"count": 1,
"items": [
{
"id": "40590",
"date": "May 10, 2026",
"title": "Hail Map Houston, TX May 10, 2026",
"category": "Scattered Damage",
"location": "Houston, TX",
"hail_size": "1.75\" Hail",
"detail_url": "https://www.hailpoint.com/40590/details/hail-map/Houston--TX-May-10.html",
"mid_base64": "NDA1OTA=",
"thumbnail_url": "https://www.hailpoint.com/uploads/maps/thumbs/20260510-2300.20260511-0800.location_196.thumbnail.png",
"homes_impacted": "448",
"population_impacted": "906"
}
],
"total_records": "0"
},
"status": "success"
}
}About the hailpoint.com API
The Hail Point API exposes 8 endpoints covering historical hail storm events across the US and Canada, returning structured data on damage categories, population and housing impact, hail size, and geographic report markers. The search_hail_maps endpoint lets you query by keyword, state, damage category, and date range, while get_hail_map_details returns a full impact breakdown table including population and area affected per hail size range.
Event Search and Filtering
The search_hail_maps endpoint accepts a keyword (city, state, or ZIP), a two-letter state code (or 'can' for Canada), a category filter (scattered, major, severe, catastrophic), a distance radius in miles, and date_from/date_to bounds. Results are paginated at 15 items per page and each item in the items array carries a detail_url, id, thumbnail_url, title, category, hail_size, location, date, and population_impac field. The same summary shape is returned by get_latest_hail_maps, get_hail_maps_by_state, and get_hail_maps_by_city, making it straightforward to switch between browse and search flows.
Detailed Storm Impact Data
get_hail_map_details takes a detail_url from any summary result and returns the full event record: title, category, event_info, hail_reports count, max_hail_size, and an impact_breakdown array. Each row in impact_breakdown contains hail_size, population, housing, and area_(sq._mi.) for that size band, making it possible to assess damage exposure at a granular level for insurance or property risk workflows.
Reference and Demo Endpoints
get_hail_damage_categories returns the platform's official category definitions (name and description), which map to the category filter values used across all search endpoints. get_hail_map_demo returns a sample storm event with up to 10 hail report sample_markers, each carrying lat, lng, and a report field — useful for testing map rendering before committing to paginated historical queries.
Geographic Shortcuts
get_hail_maps_by_state requires a two-letter US state code and pages through all events for that state. get_hail_maps_by_city accepts a city name with an optional state qualifier and returns the same paginated summary format. Both endpoints report total_records so you can pre-calculate how many pages to request.
- Insurance underwriting tools that pull
impact_breakdownhousing and population data for a property's ZIP or city before issuing a policy. - Roofing and restoration contractors querying
get_hail_maps_by_cityto identify recent severe or catastrophic events near their service area. - Property management platforms surfacing historical hail risk scores derived from
hail_sizeandcategoryfields on listing pages. - Claims automation pipelines that verify a reported storm date and location against
search_hail_mapsresults usingdate_from/date_toandkeyword. - Map-based dashboards using
get_hail_map_demoandsample_markerslat/lng fields to prototype storm visualization before loading full historical data. - Risk analytics products comparing storm frequency across states using
get_hail_maps_by_stateand aggregatingtotal_recordscounts over time. - Research tools that combine
max_hail_sizeandhail_reportsfields fromget_hail_map_detailsto rank the most impactful events in a region.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Hail Point have an official developer API?+
What does `get_hail_map_details` return beyond the summary fields?+
title, category, and event_info available in summary results, get_hail_map_details returns hail_reports (total report count), max_hail_size, and an impact_breakdown array. Each element in that array breaks down population, housing, and area_(sq._mi.) affected for a specific hail_size band, giving a layered view of storm severity that summary results don't include.Can I retrieve individual hail report markers for all historical events, not just the demo?+
lat/lng markers are only returned by get_hail_map_demo, which covers a single sample event. The other endpoints return event-level summaries and impact tables rather than per-report coordinates. You can fork this API on Parse and revise it to add a markers endpoint for arbitrary events.Does the API cover Canadian hail events?+
search_hail_maps endpoint accepts state: 'can' to filter for Canadian events. The dedicated get_hail_maps_by_state and get_hail_maps_by_city endpoints are documented for US state codes and may not return Canadian results through those routes. If you need full Canadian city-level browsing, you can fork this API on Parse and revise it to extend those endpoints.How does pagination work across the list endpoints?+
search_hail_maps, get_latest_hail_maps, get_hail_maps_by_state, get_hail_maps_by_city) return up to 15 items per page. The response includes a page integer, a count of items on the current page, and a total_records string (or null) so you can calculate the total number of pages needed to retrieve a full result set.