{"uid":"cap_cjxxbcjTFZ3pMnaidD-th","slug":"halowerk-location-heatmap-15d03268","name":"Halowerk Location Heatmap","description":"Returns the geographic places named in coverage of a topic, each with the number of articles mentioning it, the number of distinct sources, and coordinates where the source supplies them. The distinction the service is built on is between mention and occurrence: an article about a decision taken in Brussels affecting mining in Chile names both places, and reading the resulting map as an event map puts the decision in Chile and the mining in Brussels.","url":"https://research.halowerk.com/v1/location-heatmap","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","default":50,"maximum":200,"minimum":5},"topic":{"type":"string","maxLength":200,"minLength":3},"timespan":{"type":"string","default":"7d","maxLength":6}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JEI4Kty14vZIjd9tbEF0a","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Extracts geographic places mentioned in news coverage of a topic, returning each location with article count, source count, and coordinates — distinguishing where events occurred from where they were merely referenced.","exampleAgentPrompt":"Can you map the geographic locations mentioned in news coverage of the EU carbon border adjustment mechanism — I want to see which places appear most, how many articles mention each, and how many distinct sources are citing them?","exampleUseCases":[{"title":"Conflict coverage geographic footprint","prompt":"Show me a location heatmap for news coverage about the Sudan conflict — I want to know which cities and countries are most mentioned, with article counts and source counts for each place."},{"title":"Policy impact geography from news","prompt":"Search news coverage of the CHIPS Act and extract all the geographic places being mentioned — I need coordinates, article counts, and source diversity for each location so I can build a map of where the story is landing."},{"title":"Supply chain risk location mapping","prompt":"I'm researching lithium supply chain disruptions — can you pull all the geographic locations named in recent coverage of that topic and tell me how many articles and sources mention each place?"}],"resultDescription":"A list of geographic places found in news coverage of the queried topic, each with the place name, number of articles mentioning it, number of distinct sources referencing it, and coordinates (latitude/longitude) where available. The data distinguishes between places where events occurred versus places merely referenced in passing, enabling accurate event-location mapping.","failureModes":["Topic query too vague returns very broad or noisy location sets","No articles found for niche or very recent topics returns empty results","Coordinates absent for ambiguous or lesser-known place names","Place name disambiguation errors when a name refers to multiple locations","High volume of coverage may return truncated result sets"],"whenToPreferThis":"Choose this endpoint when you need to understand the geographic distribution of media coverage for a topic — particularly when you want to distinguish where events are actually occurring versus where they are merely referenced. It is ideal for building news heatmaps, tracking regional media attention, or doing geopolitical research where location-event attribution matters. Prefer it over generic geocoding services because it operates on the news corpus itself rather than on a user-supplied text.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:34:58.697Z","isFirstParty":false}