Skip to Content
Drip Docs
API referenceStories

Get a story

One story: what happened, how it developed, and what people are saying. Id is story:123, 123, or an arc id.

GET
/v1/stories/{id}

One story: what happened, how it developed, and what people are saying. Id is story:123, 123, or an arc id.

Authorization

bearerAuth
headerAuthorizationBearer <drip_live>

An API key from Drip settings. Send it as Authorization: Bearer drip_live_… . The key is shown once.

Path Parameters

id*string

story:123, a snapshot id, or an arc id.

Query Parameters

scope?string

arc (default) or event.

since?string

YYYY-MM-DD or a relative window.

discussion_limit?integer

Discussion entries. Default 10, max 25.

detail?string

compact (default) or full.

workspace_id?integer

Workspace id, for tracked flags. Required when the account has more than one.

Response Body

status ok, no_results, no_material_updates, partial or not_covered. Branch on status.

application/json
  1. response
coverage*
discussion*array<>
discussion_count*number
scope*
status*string
story*
timeline?array<>
timeline_count?number
window?
Example Request
curl -X GET 'https://api.joindrip.ai/v1/stories/string'
Example Response
{  "coverage": {    "note": "string"  },  "discussion": [    {      "about_event": "string",      "clip": {        "content_section_id": 0,        "deep_link": "string",        "start_seconds": 0      },      "evidence_id": "string",      "guests": [        {          "name": "string",          "person_id": 0        }      ],      "headline": "string",      "kind": "string",      "outlet": "string",      "published": "string",      "source_type": "string",      "summary": "string",      "takes": [        {          "adds_something_new": true,          "quote": "string",          "take": "string"        }      ],      "url": "string"    }  ],  "discussion_count": 0,  "scope": {    "scope": "string",    "story": "string",    "tool": "string"  },  "status": "string",  "story": {    "description_card": "string",    "entities": [      {        "company": "string",        "domain": "string",        "id": 0,        "name": "string",        "role": "string",        "ticker": "string",        "title": "string",        "type": "string"      }    ],    "event_date": "string",    "evidence_id": "string",    "headline": "string",    "key_points": [      "string"    ],    "kind": "string",    "source_count": 0,    "sources": [      {        "is_primary": true,        "outlet": "string",        "published": "string",        "source_type": "string",        "title": "string",        "url": "string"      }    ],    "story_id": 0,    "type": "string"  },  "timeline": [    {      "before": true,      "date": "string",      "discussion_count": 0,      "evidence_id": "string",      "headline": "string",      "is_this_story": true,      "source_count": 0    }  ],  "timeline_count": 0,  "window": {    "anchor_date": "string",    "date_basis": "string",    "lead_up": "string",    "since": "string",    "until": "string"  }}