Bellwork
Start free
NewsId

Get a single news article

Single article with ALL its non-noise signals (unfiltered), for drill-down. Same API-key-only access as GET /news.

GET
/news/{id}

Single article with ALL its non-noise signals (unfiltered), for drill-down. Same API-key-only access as GET /news.

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

Path Parameters

id*string

Article id

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://loading/api/v1/news/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "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"
        }
      }
    ]
  }
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "Forbidden",
  "message": "string",
  "module": "string"
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}

Search the news signals feed GET

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.

List opportunities GET

Agent-produced, verified sales opportunities for the caller's projects. There is no review gate: an opportunity is visible to its owner the moment the agent writes it. An opportunity is written once from a signal and is NOT re-verified on its own, so a vacancy can since have been filled. Read `verification_status` and `last_verified_at` before acting on a row, and call POST /opportunities/{id}/refresh to re-check it. A row that has never been re-checked reports `verification_status: "unverified"` and a null `last_verified_at` rather than implying freshness.