πŸ“ Local SEO Heatmap API Pin Data

Camilo Aponte

Camilo Aponte

Last updated on Nov 9, 2026

πŸ“Œ What the colored pins mean

The Local SEO Heatmap shows how a business ranks for a keyword across a map grid. Each colored pin is one grid point. The color is a visual summary of the rank at that point, not a separate data type stored on its own.

  • Green usually means a strong position, typically near the top of local results.
  • Yellow or orange usually means a mid-range position.
  • Red usually means a weak position or that the business was not found in the checked results.
  • Exact color bands can vary slightly by report settings. Always use the legend on the heatmap you are viewing.

The pin itself represents the grid location, the keyword, the scan date, and the rank result. Color is calculated from that rank so the map is easy to scan.

πŸ”Œ Can you get pin data from the API?

Yes, if your plan includes API access. The API returns the underlying scan results that the heatmap draws as pins. You should expect fields such as the keyword, grid coordinates, business or location identifier, scan time, and rank position. You generally will not receive a separate β€œpin color” object. Derive the color in your own app from the rank value and the same bands shown in the product legend.

If a field for color or rank bucket is present in the response, you may use it directly. If it is not, map the numeric rank yourself so your colors stay aligned with the heatmap.

πŸ› οΈ How to pull the data

  1. Confirm API access is enabled on your Search Atlas account.
  2. Open Settings β†’ API Keys β†’ API documentation at docs.searchatlas.com. Use Local SEO Heatmaps for pin data inside the product.
  3. Authenticate with the key or token shown there. Do not share that credential outside your team.
  4. Request the heatmap or grid-scan results for the location, keyword, and date you need.
  5. Read each grid point’s rank, latitude, longitude, and keyword.
  6. Apply your color rules from the rank so pins match the in-product legend.

Use the documented resource names and parameters only. Endpoints and field names can change, so the in-platform API reference is the source of truth. Do not hard-code colors from an old export if the legend in the product has been updated.

🎨 A simple way to map ranks to colors

After you receive each pin’s rank, group it before you draw it:

  • Treat a top-tier rank as green.
  • Treat a middle rank as yellow or orange.
  • Treat a low rank, or no ranking, as red.
  • Match the cutoffs to the legend on your heatmap so reports and API visuals agree.

Store the raw rank as well as the color. Rank is the durable value. Color is only a display choice and can be recalculated later.

⚠️ If the pins do not match

  • Check that you queried the same location, keyword, grid, and scan date as the heatmap on screen.
  • Confirm you are not mixing an older scan with a newer map.
  • Verify your color bands match the legend, including how β€œnot found” is shown.
  • Refresh API documentation if a field you expected is missing. Missing color is normal when only rank is returned.

**πŸ’¬ Need a hand?

If you need further assistance, open the chat widget in the bottom-right corner of the platform and send your message. A member of our support team will reply in the chat.

Was this article helpful?