Skip to main content

Release Notes

Changes to the SearchLight API, newest first. The API is in beta; see the overview for its current status.

2026-08-05 · Organization keys retired​

  • Organization keys no longer authenticate; requests carrying one return 401. Generate a user API key in the SearchLight app under Settings → API; see authentication.

2026-08-04 · Benchmarks, insights, and access discovery​

  • GET /api/<organization>/benchmarks returns anonymized industry benchmarks for a calendar month (month=YYYY-MM; the current month returns month to date): the industry figure for each metric plus the range accounts fall into, across the rate, cost-per and ROAS metrics, optionally broken out by attribution category, attribution channel, customer status or business unit. See benchmarks.
  • GET /api/<organization>/insights returns the AI-generated performance insights published for your accounts, with fields to select individual document sections. See insights.
  • GET /api lists the organizations you can request, the accounts under each, the endpoints available to you, and the full field dictionary, which helps when you don't know which organization id to use. It is the only endpoint with no organization in its path, and requires a user API key. See access.
  • Error responses now carry a machine-readable code alongside the error message.
  • Requests are rate limited per user per hour; past the limit they return 429 until the hour passes.
  • Oversized events requests (too many account×interval combinations, or too many result rows) now return a 400 whose message says what to reduce.
  • Two new response codes: 502 when an upstream data service fails, and 503 when benchmark data for a month is still being gathered and the request should be retried.

2026-07-28 · User API keys and organization paths​

  • User API keys: generate your own key in the SearchLight app under Settings → API. A user key can request anything your login has access to, and can be rotated or deleted from settings at any time. See authentication.
  • Organization path segment: the path segment previously documented as <your-group-key> is now <organization>. Existing group-key URLs are unchanged. This is a naming clarification, not a breaking change.
  • Organization keys deprecated: existing organization keys continue to authenticate until they are retired, but can no longer be created, rotated, or renamed. Switch to a user API key.
  • Explicit 404 for inaccessible organizations: a path segment that doesn't match an organization or account your credentials can access now returns 404 instead of an empty 200.

2026-07-06 · date dimension now ISO formatted​

  • The date dimension is now returned as YYYY-MM-DD (previously MM/DD/YYYY), matching every other date field in the API. Update any parsing that expected the US format; date strings now also sort chronologically.

2026-06-18 · Initial beta release​

  • GET /api/<your-group-key>/events returns aggregated metrics over a date range, broken out by the dimensions you select. See events.
  • Field selection through fields, combining dimensions and metrics in a single request.
  • Filtering on any field, including comparison operators and cross-field filter logic.
  • interval support (total, month, week, day) for splitting ranges beyond the 90-day window.
  • Lead-grading dimensions for accounts subscribed to lead grading.