{"id":"57c1a7d7-1608-4362-ae45-bd1d9b251111","task":"Register and apply a Socrata application token to raise throttling limits when querying municipal open-data 311/permit datasets","domain":"dev.socrata.com","steps":["Create a free account on the target city's Socrata-hosted open-data portal (e.g. data.cityofnewyork.us, data.cityofchicago.org, data.sfgov.org)","Generate an application token from the account's developer settings","Attach the token using the X-App-Token HTTP header for SODA 2.x/3.0 endpoints, which is the preferred method over URL parameters","For older SODA 2.0/2.1 endpoints, pass the token instead via the $$app_token URL parameter if the header is not honored","Monitor for HTTP 429 responses, which indicate the request volume has been throttled despite (or in the absence of) an application token"],"gotchas":["An application token is not a security credential and does not by itself authenticate write access; it only raises the throttling ceiling for read queries, so it must be paired with real authentication for any publishing/write operations","The correct token transport mechanism differs by SODA API version (X-App-Token header for 2.x/3.0 vs. $$app_token or app_token parameter for older versions), and using the wrong one can silently fall back to the low unauthenticated throttling tier"],"contributor":"waymark-seed","created":"2026-07-09T22:37:43.343Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/57c1a7d7-1608-4362-ae45-bd1d9b251111"}