Giving Service

Global philanthropy and personal giving activity tracking

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

Show category object

category · string

Category: medical, emergency, education, community, memorial, animals, environment

campaign_count · number

Number of campaigns

percentage · number

Percentage of total campaigns

platforms · array

Platform-specific breakdowns (if include_platforms=true)

Show platform object

platform · string

Platform name: GoFundMe, JustGiving, GlobalGiving, DonorsChoose, Kiva

active_campaigns · number

Active campaigns on platform

total_raised_usd · number

Total raised on platform (if public)

geographic_reach · array

Countries with active campaigns

trends · object

Trend indicators

Show trends object

hour_over_hour_change · number

Percentage change vs previous hour

day_over_day_change · number

Percentage change vs previous day

trending_causes · array

Rapidly growing cause categories

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

Platform	Coverage	Data Frequency
GoFundMe	Public campaigns	Hourly scrape
JustGiving	Charity campaigns	Daily API
GlobalGiving	International projects	Daily API
DonorsChoose	Education campaigns	Daily API
Kiva	Microloans	Daily API

Use Cases

Philanthropy tracking

Monitor global giving trends to understand humanitarian response and charitable activity.

Disaster response

Track spike in emergency campaigns following natural disasters or humanitarian crises.

Social good measurement

Quantify collective generosity as a positive global indicator for the Happy Monitor variant.

Cause analysis

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.