{"name":"InstaMaps API","base_url":"https://get-instamaps.com/v1","docs":"https://get-instamaps.com/developers","portal":"https://get-instamaps.com/developers/portal","openapi":"https://get-instamaps.com/openapi.json","auth":"Authorization: Bearer <your API key> (or X-API-Key). Keys are free: sign in with Google at /developers/portal.","free_tier":"2,500 lookups a day per account, every endpoint, reset at midnight UTC. No card.","lookups":["One lookup per row a call carries: an address placed, a journey measured, a stop routed, a place checked.","A question to ask_table is 10 lookups, however long the table.","A drive-time area is 10 lookups a band, plus one per place checked against it.","Maps, live hazards and postcode-radius lists are one lookup a call. Checking a background job (get_job) is free.","Rows sent by reference (a Google Sheet, a Drive file or an earlier run) are counted from the answer."],"pricing":{"free":{"lookups_per_day":2500,"note":"Every endpoint, no card. Resets at midnight UTC."},"more":"Need more than that? Write to gbade@get-instamaps.com and tell us what you are building."},"endpoints":[{"method":"POST","path":"/v1/geocode_batch","summary":"Turn a list of addresses, business names, postcodes or coordinates into points, with a confidence and the address parts for every row.","docs":"https://get-instamaps.com/developers#geocode_batch"},{"method":"POST","path":"/v1/filter_by_location","summary":"Which records are within N miles or km of one or more sites, or the nearest sites to each record, by straight-line distance.","docs":"https://get-instamaps.com/developers#filter_by_location"},{"method":"POST","path":"/v1/ask_table","summary":"Answer a plain-English question about a whole table (filters, counts, distances to a named place or a second list), showing how it read the question.","docs":"https://get-instamaps.com/developers#ask_table"},{"method":"POST","path":"/v1/get_road_distances","summary":"Road distance and drive time for each from–to journey, on our own road network, with typical weekday traffic.","docs":"https://get-instamaps.com/developers#get_road_distances"},{"method":"POST","path":"/v1/plan_routes","summary":"Split up to 100 stops across up to 10 drivers from one depot, in the best order on real roads, with Google Maps links per driver.","docs":"https://get-instamaps.com/developers#plan_routes"},{"method":"POST","path":"/v1/get_travel_time_area","summary":"The area reachable from a place within N minutes by car, on foot or by bike, and which of your records fall inside each band.","docs":"https://get-instamaps.com/developers#get_travel_time_area"},{"method":"POST","path":"/v1/get_location_facts","summary":"The official areas each address falls in: US census tract, income level, county, metro, HUBZone, Opportunity Zone, USDA eligibility, FEMA flood zone; GB conservation area, listed buildings, nearest UPRN, England flood zone.","docs":"https://get-instamaps.com/developers#get_location_facts"},{"method":"POST","path":"/v1/get_area_risk","summary":"One risk fact per place: recorded crime nearby (England and Wales) with the commonest types, flood zone (England, US), or FEMA natural-hazard rating (US). Flood answers also compare: base flood elevation, the neighbourhood's river and coastal flooding with its national percentile (US), the rank on the list and a sentence in words, on a map over the official flood zones.","docs":"https://get-instamaps.com/developers#get_area_risk"},{"method":"POST","path":"/v1/find_postcodes_in_radius","summary":"Every US ZIP code, or UK postcode sector or district, within a radius of a place, nearest first.","docs":"https://get-instamaps.com/developers#find_postcodes_in_radius"},{"method":"POST","path":"/v1/get_live_hazards","summary":"Warnings and events in force now: England's flood warnings, US weather warnings, and worldwide earthquake shaking, hurricanes, floods, wildfires and volcanoes, with kind, level, area, times and outline.","docs":"https://get-instamaps.com/developers#get_live_hazards"},{"method":"POST","path":"/v1/check_live_hazards","summary":"Which of your places are inside or near a warning or event now (or were hit by one), with insured values added up.","docs":"https://get-instamaps.com/developers#check_live_hazards"},{"method":"POST","path":"/v1/find_nearby","summary":"The nearest, the count, or a list of places of a kind (stations, schools, supermarkets, pharmacies…) around each address.","docs":"https://get-instamaps.com/developers#find_nearby"},{"method":"POST","path":"/v1/find_official_places","summary":"The official record: A&E departments, hospitals, GP practices, care homes and dentists with CQC ratings, NHS pharmacies, food hygiene ratings; or the record of the business at each row.","docs":"https://get-instamaps.com/developers#find_official_places"},{"method":"POST","path":"/v1/render_map","summary":"A hosted, layered map to keep or share: pins, lines or areas, colours by field, a legend, GeoJSON and KML.","docs":"https://get-instamaps.com/developers#render_map"},{"method":"POST","path":"/v1/update_map","summary":"Change a kept map in place: add or remove layers, move or add pins, recolour, rename; the link stays the same and earlier versions are kept.","docs":"https://get-instamaps.com/developers#update_map"},{"method":"POST","path":"/v1/get_map","summary":"Look at a kept map from an earlier conversation: its layers, pin ids and fields. With no map named, list the person's own maps, including the ones they made in the InstaMaps Google Sheets add-on.","docs":"https://get-instamaps.com/developers#get_map"},{"method":"POST","path":"/v1/delete_map","summary":"Delete the person's own maps for good, made here or in the InstaMaps Google Sheets add-on: the link stops working and the pins, versions, logbook and photos go with it.","docs":"https://get-instamaps.com/developers#delete_map"},{"method":"POST","path":"/v1/combine_runs","summary":"Join two to six kept runs on the place ID every tool returns (record_key) and say what changed between them.","docs":"https://get-instamaps.com/developers#combine_runs"},{"method":"POST","path":"/v1/get_job","summary":"How far a background job has got: status, rows done, minutes left, and its run_id when done.","docs":"https://get-instamaps.com/developers#get_job"},{"method":"POST","path":"/v1/write_to_sheet","summary":"Put an earlier answer into a Google Sheet: new dated columns beside the rows it came from, or a new tab. Never overwrites a cell. The only tool that writes.","docs":"https://get-instamaps.com/developers#write_to_sheet"}]}