Overview
No authentication is required. The Cambridge 311 dataset is publicly available via the City of Cambridge's Open Data portal, powered by Socrata/Tyler Technologies. You can optionally add a free Socrata app token for higher rate limits (below).
Setup guide
Add it to Ingest
In the Ingest UI under Connectors → Cambridge 311, no credentials are required — just activate the connector.
Optional: add a Socrata app token for higher rate limits
Anonymous access works fine, but Socrata throttles unauthenticated traffic from a shared per-source-IP pool. A free Socrata app token grants a higher, dedicated quota — worth adding if you run heavy or frequent refreshes.
- Go to data.cambridgema.gov/profile/edit/developer_settings and sign in (or create a free account).
- In the App Tokens section, click Create New App Token, give it a name (e.g.
Ingest), and save. - Copy the value in the App Token column (about 25 characters). Do not use the Secret Token — that is a separate credential this connector does not use.
- Paste it into the Socrata app token (optional) field when you configure the 311 Service Requests endpoint.
The token is sent as the $$app_token query parameter. Leave the field blank for anonymous access. Important: an incorrect token makes requests fail with HTTP 403 — paste a valid token or leave it blank. (Socrata app tokens work across Socrata portals, so the same token can also serve the Somerville 311 connector.)
Mind the limits
Ingest reads the dataset through Socrata and dispatches at 5 requests/second. Unauthenticated traffic draws from a shared pool throttled by source IP — ample for this dataset's refresh cadence — and the optional app token above raises that limit.
Supported streams
1 endpoint are available out of the box. Each endpoint syncs into its own Iceberg table in Snowflake.
| Endpoint | Description | Reference |
|---|---|---|
| list_311_cases list_311_cases | – |
Authentication
- Auth type
- None
- Provider docs
- dev.socrata.com ↗
Performance & limits
- Rate limit
- 5 requests/second (unauthenticated); higher with optional app token