News

Search the news signals feed

External, API-key-only feed of categorized K-12 news articles. An article is returned iff it has at least one non-noise signal matching the topic/intent filters. Requires an API key with the `news:read` scope, on an org entitled to the `news_signals` module -- session/OAuth auth is rejected. **Free (0 credits).**

GET
/news

External, API-key-only feed of categorized K-12 news articles. An article is returned iff it has at least one non-noise signal matching the topic/intent filters. Requires an API key with the news:read scope, on an org entitled to the news_signals module -- session/OAuth auth is rejected. Free (0 credits).

Authorization

apiKeyAuth
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)

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/news"
{
  "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
  }
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "Forbidden",
  "message": "string",
  "module": "string"
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}