Skip to main content
The GivingService provides aggregated data on global personal giving, charitable donations, and philanthropy trends for the Happy Monitor variant.

​
Base Path

/api/giving/v1

​
Endpoints

​
GetGivingSummary

Retrieves a composite global giving activity index with platform-specific breakdowns. HTTP Method: GET Path: /api/giving/v1/get-giving-summary

​
Request Parameters

​
include_platforms
boolean
default:"true"
Include platform-specific breakdowns (GoFundMe, JustGiving, etc.)
​
timeframe
string
default:"24h"
Timeframe for aggregation: 24h, 7d, 30d, ytd

​
Response Fields

​
global_index
number
Composite giving activity index (0-100, normalized)
​
total_campaigns
number
Total active campaigns across all platforms
​
total_donors
number
Estimated total donors (deduplicated where possible)
​
total_amount_usd
number
Total donations in USD (estimated from public data)
​
top_categories
array
Top donation categories by volume
​
platforms
array
Platform-specific breakdowns (if include_platforms=true)
​
trends
object
Trend indicators

​
Example Request

curl "https://happy.worldmonitor.app/api/giving/v1/get-giving-summary?timeframe=24h&include_platforms=true"

​
Example Response

{
  "global_index": 68.5,
  "total_campaigns": 125000,
  "total_donors": 3400000,
  "total_amount_usd": 48500000,
  "top_categories": [
    {
      "category": "medical",
      "campaign_count": 42000,
      "percentage": 33.6
    },
    {
      "category": "emergency",
      "campaign_count": 28000,
      "percentage": 22.4
    }
  ],
  "platforms": [
    {
      "platform": "GoFundMe",
      "active_campaigns": 95000,
      "total_raised_usd": 35000000,
      "geographic_reach": ["US", "CA", "GB", "AU"]
    }
  ],
  "trends": {
    "hour_over_hour_change": 2.3,
    "day_over_day_change": 8.7,
    "trending_causes": ["disaster_relief", "community_support"]
  }
}

​
Data Aggregation

The Giving Index is calculated from:
  1. Campaign velocity: New campaigns created per hour
  2. Donor activity: Unique donors per platform (deduplicated by email hash where possible)
  3. Donation volume: Total USD raised across platforms
  4. Geographic spread: Number of countries with active campaigns
Normalized to 0-100 scale with historical baseline (90-day rolling average).

​
Supported Platforms

PlatformCoverageData Frequency
GoFundMePublic campaignsHourly scrape
JustGivingCharity campaignsDaily API
GlobalGivingInternational projectsDaily API
DonorsChooseEducation campaignsDaily API
KivaMicroloansDaily API

​
Use Cases

Monitor global giving trends to understand humanitarian response and charitable activity.
Track spike in emergency campaigns following natural disasters or humanitarian crises.
Quantify collective generosity as a positive global indicator for the Happy Monitor variant.
Identify trending causes and emerging social needs based on campaign category distribution.

​
Happy Monitor Integration

Giving data is displayed on the Happy Monitor variant with:
  • Live humanity counters: Real-time tallies of active donors and campaigns
  • Giving gauge: Animated 0-100 index with trend arrow
  • Top causes carousel: Rotating display of trending categories
  • Platform leaderboard: Comparative giving activity across platforms
The Giving Index is designed to show collective human generosity and compassion, providing a counterweight to negative news.
Donation amounts are estimated from public data and may undercount private or offline giving.
Not all platforms provide real-time APIs. Some data (e.g., JustGiving) may lag by 24 hours.

Build docs developers (and LLMs) love

Get started for freeTalk to us