Headcount Labs Places

Find shops, restaurants, cafes, libraries, pharmacies and other places near a point, nearest first. Filter by name text (q), brand (e.g. Starbucks), category (e.g. boba, cafe, library, pharmacy), open_now, or open at a given time (at). Use walk_minutes for 'within N minutes' walk'. open_now is null when hours are unknown; unknown is not closed. Covers the 20 largest U.S. cities. Fields: name, brand, category, distance_m, lat, lon, address, unit, phone, website, hours, open_now, open_reason, health_grade, operating_status, cuisine_canonical, socials. The record id (and any other UUID, including place_id, product_id, series_id, and company_id) is an opaque handle: use it only as an argument to a follow-up tool call (get_company, get_product, get_event, get_event_series, a get_..._record tool, or another tool's id argument). Never show internal ids or UUIDs to the user unless the user explicitly asks for them. Public identifiers may be shown: SEC CIK, LEI, UEI, Wikidata QID, website or domain, ticker, barcode (GTIN), and a public URL.

find_places

The full stored record of one place by its UUID (the id returned by find_places or get_place): every field with the source it came from. Use it when the user asks where a fact comes from or wants detail the compact tools leave out. Takes only the id. The record id (and any other UUID, including place_id, product_id, series_id, and company_id) is an opaque handle: use it only as an argument to a follow-up tool call (get_company, get_product, get_event, get_event_series, a get_..._record tool, or another tool's id argument). Never show internal ids or UUIDs to the user unless the user explicitly asks for them. Public identifiers may be shown: SEC CIK, LEI, UEI, Wikidata QID, website or domain, ticker, barcode (GTIN), and a public URL.

get_place_record

One shop, restaurant, cafe or other place by its UUID (from find_places or resolve): name, brand, category, address, phone, website, weekly hours, whether it is open now (null when hours are unknown) and the NYC inspection grade. Fields: name, brand, category, cuisine, lat, lon, address, phone, website, hours, open_now, open_reason, health_grade, operating_status, cuisine_canonical, phone_extension, socials, unit. The record id (and any other UUID, including place_id, product_id, series_id, and company_id) is an opaque handle: use it only as an argument to a follow-up tool call (get_company, get_product, get_event, get_event_series, a get_..._record tool, or another tool's id argument). Never show internal ids or UUIDs to the user unless the user explicitly asks for them. Public identifiers may be shown: SEC CIK, LEI, UEI, Wikidata QID, website or domain, ticker, barcode (GTIN), and a public URL.

get_place

Count branded places (chains like Starbucks, CVS, McDonald's) near a point, optionally in one category: top 25 brands with their number of locations, plus how many places in range have no brand (independents). The record id (and any other UUID, including place_id, product_id, series_id, and company_id) is an opaque handle: use it only as an argument to a follow-up tool call (get_company, get_product, get_event, get_event_series, a get_..._record tool, or another tool's id argument). Never show internal ids or UUIDs to the user unless the user explicitly asks for them. Public identifiers may be shown: SEC CIK, LEI, UEI, Wikidata QID, website or domain, ticker, barcode (GTIN), and a public URL.

brand_counts