Bellwork
Start free
Signals

Search the enterprise signals feed

Enterprise catalog-wide signals feed -- the same underlying data and query shape as GET /news, but accessible via session, OAuth, or API-key auth (not API-key-only), and gated by the `signals` module entitlement instead of `news_signals`. Org must have the Signals Feed module enabled; otherwise responds 403 entitlement_required.

GET
/signals

Enterprise catalog-wide signals feed -- the same underlying data and query shape as GET /news, but accessible via session, OAuth, or API-key auth (not API-key-only), and gated by the signals module entitlement instead of news_signals. Org must have the Signals Feed module enabled; otherwise responds 403 entitlement_required.

Authorization

AuthorizationBearer <token>

API key (sk_live_... prefix). Generate keys in the UI under Settings > API Keys, then send it as Authorization: Bearer sk_live_...

In: header

Query Parameters

signal_type?string

Comma-separated signal types to filter by

buying_intent?string

Comma-separated intents: low, medium, high

district_id?string

Comma-separated district UUIDs (watchlist)

school_id?string

Comma-separated school UUIDs (watchlist)

query?string

Topic query matched against signal summaries, source titles, and buying-intent reasons

Length2 <= length <= 500
state?string

Comma-separated two-letter state codes

since?string

ISO timestamp ingest cursor for nightly sync

Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
Formatdate-time
published_after?string
Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
Formatdate-time
published_before?string
Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
Formatdate-time
limit?integer
Default50
Range1 <= value <= 200
offset?integer
Default0
Range0 <= value <= 9007199254740991

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://loading/api/v1/signals"
{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "url": "string",
      "title": "string",
      "domain": "string",
      "author": "string",
      "description": "string",
      "published_at": "string",
      "signals": [
        {
          "signal_type": "chronic_absenteeism",
          "buying_intent": "none",
          "buying_intent_reason": "string",
          "summary": "string",
          "signal_date": "string",
          "signal_date_confidence": 0,
          "extraction_confidence": 0,
          "evidence": null,
          "payload": null,
          "entity_type": "string",
          "entity_resolution_status": "string",
          "entity_match_confidence": 0,
          "entity_match_reason": "string",
          "district": {
            "id": "string",
            "name": "string",
            "state": "string",
            "nces_id": "string"
          },
          "school": {
            "id": "string",
            "name": "string",
            "state": "string"
          }
        }
      ]
    }
  ],
  "pagination": {
    "total": -9007199254740991,
    "limit": -9007199254740991,
    "offset": -9007199254740991,
    "has_more": true,
    "total_exact": true
  }
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "entitlement_required",
  "module": "string",
  "message": "string",
  "contact": "string"
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}

Get school vendor stack GET

Get technology/vendor stack for a school.

Search the leadership transitions feed GET

Enterprise catalog-wide feed over deduped K-12 leadership transition events (`leadership_transitions`) -- one row per person moving into or out of one role at one district, tracked through its lifecycle (rumored → search → finalist → confirmed → effective → departed). Filter by role class, state, lifecycle stage, transition type, buying intent, announced-date window, and a person/district keyword. Defaults exclude historical-reference mentions and district-unresolved events. Gated by the `leadership_transitions` module entitlement; otherwise responds 403 entitlement_required.