Skip to main content
GET
/
impact
/
stories
Browse Stories
curl --request GET \
  --url https://api.givingcompass.org/insights/impact/stories \
  --header 'X-API-Key: <api-key>'
{
  "items": [
    {
      "ein": "<string>",
      "organization_name": "<string>",
      "story_title": "<string>",
      "story_id": "<string>",
      "emotional_hook": "<string>",
      "full_quote": "<string>",
      "quote_attribution": "<string>",
      "protagonist": "<string>",
      "before_state": "<string>",
      "transformation_moment": "<string>",
      "after_state": "<string>",
      "time_to_impact": "<string>",
      "obstacles_overcome": [
        "<string>"
      ],
      "metrics": [
        {
          "metric_id": "<string>",
          "metric_text": "<string>",
          "metric_type": "<string>",
          "metric_value": 123,
          "unit": "<string>",
          "geo_impact": "<string>",
          "time_aggregation": "<string>"
        }
      ],
      "ripple_effect": "<string>",
      "call_to_action": "<string>",
      "story_category": "<string>",
      "identity_alignment": "<string>",
      "date_extracted": "<string>",
      "source_url": "<string>",
      "report_year": 123,
      "power_score": 123,
      "confidence_score": 123
    }
  ],
  "total": 123,
  "page": 123,
  "size": 123
}

Authorizations

X-API-Key
string
header
required

Add a header [X-API-Key] with the token

Query Parameters

q
string | null

Semantic search query for finding relevant stories

eins
string[] | null

Filter by one or more nonprofit EINs

min_power_score
number | null

Minimum power score (0-10)

Required range: 0 <= x <= 10
page
integer
default:1

Page number

Required range: x >= 1
size
integer
default:20

Page size

Required range: 1 <= x <= 100

Response

Successful Response

items
InsightsImpactStoryResponse · object[]
required
total
integer
required
page
integer
required
size
integer
required