# GDELT Cloud

## Docs

- [API DOCUMENTATION GUIDE](https://docs.gdeltcloud.com/API_DOCUMENTATION_GUIDE.md)
- [CAMEO+ Events Aggregate Summary](https://docs.gdeltcloud.com/api-reference/cameoplus-events/cameo+-events/cameo+-events-aggregate-summary.md): Returns aggregated totals + bucketed counts with latent attribute averages for CAMEO+ coded events. Designed as the 'broad and shallow' layer — understand event intensity and domain activity before drilling into individual events via `/api/v1/cameoplus-events`.
- [List CAMEO+ Events](https://docs.gdeltcloud.com/api-reference/cameoplus-events/cameo+-events/list-cameo+-events.md): Returns GDELT Cloud AI-coded CAMEO+ multi-domain event records derived from GDELT Cloud Story clusters. Events span nine universal domains: POLITICAL, ECONOMIC, CORPORATE, TECHNOLOGY, INFRASTRUCTURE, ENVIRONMENT, HEALTH, DEMOGRAPHIC, and INFORMATION. Each event carries four latent attributes (magnit…
- [Conflict Events Aggregate Summary](https://docs.gdeltcloud.com/api-reference/conflict-events/conflict-events/conflict-events-aggregate-summary.md): Returns aggregated totals + bucketed counts for conflict events. Designed as the 'broad and shallow' layer — understand the shape and scale of a situation before drilling into individual events via `/api/v1/conflict-events`.
- [List Conflict Events](https://docs.gdeltcloud.com/api-reference/conflict-events/conflict-events/list-conflict-events.md): Returns GDELT Cloud AI-coded ACLED-style conflict and political violence events derived from GDELT Cloud Story clusters. Each event follows the ACLED methodology with a 3-level classification (disorder_type → event_type → sub_event_type), actor pair coding, geographic location, fatality count, and a…
- [Get Domain Profile](https://docs.gdeltcloud.com/api-reference/domains/domains/get-domain-profile.md): Returns a news domain profile: aggregate stats, daily timeline, top persons, top organizations, and recent articles sorted by date DESC.
- [Get GEG Entity Profile](https://docs.gdeltcloud.com/api-reference/entities/geg-entities/get-geg-entity-profile.md): Returns a GDELT Cloud Entity profile for a Wikipedia-linked entity with compact reference cards linking to other API products. Linked stories are cluster reference cards (use media-events/cluster to hydrate). Co-occurrences are entity reference cards (use entity-geg to hydrate). Supports progressive…
- [Top Entities by Coverage](https://docs.gdeltcloud.com/api-reference/entities/geg-entities/top-entities-by-coverage.md): Returns the most-covered people and organizations in a given time window, ranked by total article count across all sources. Backed by pre-aggregated daily entity coverage data joined to the entity master for type and Wikipedia URL. Ideal for building briefing dashboards, trending person/org trackers…
- [API v1 Reference](https://docs.gdeltcloud.com/api-reference/introduction.md): Legacy Developer API for existing integrations
- [Deep-Dive Into a Cluster](https://docs.gdeltcloud.com/api-reference/media-events/media-events/deep-dive-into-a-cluster.md): Deep-dive into a single media event cluster with progressive disclosure. Returns voting articles (top 5 ranked), common entities, and resolved metrics. Supports `detail` for response size control and filters (`actor_country`, `location`, `language`, `domain`, `category`) to explore specific angles o…
- [Media Events Aggregate Summary](https://docs.gdeltcloud.com/api-reference/media-events/media-events/media-events-aggregate-summary.md): Returns aggregated story-cluster totals, grouped buckets, and top underlying clusters for the media-event layer. Supports geographic rollups by country, region, and continent, plus actor-geo attribution via `geo_basis`.
- [Top Media Event Clusters](https://docs.gdeltcloud.com/api-reference/media-events/media-events/top-media-event-clusters.md): Returns the top media event clusters for a given time window as reference cards. Supports progressive disclosure via the `detail` parameter: `summary` (~120 tokens/cluster) for compact headline cards with key metrics and top entities/sources, `standard` (~500 tokens/cluster) for resolved metrics + 5…
- [API v2](https://docs.gdeltcloud.com/api-reference/v2.md): Clean Events, Stories, Entities, and geo discovery endpoints for generated GDELT Cloud data.
- [Get Entity](https://docs.gdeltcloud.com/api-reference/v2-endpoints/entities/get-entity.md): Fetch one Entity profile with linked Stories and Events.
- [Search Entities](https://docs.gdeltcloud.com/api-reference/v2-endpoints/entities/search-entities.md): Discover linked people, organizations, and locations that connect to Stories and Events.
- [Get Event](https://docs.gdeltcloud.com/api-reference/v2-endpoints/events/get-event.md): Fetch one known structured Event by ID.
- [Search Events](https://docs.gdeltcloud.com/api-reference/v2-endpoints/events/search-events.md): Search generated structured Events. By default, list results use confidence_profile=precise, which filters to confidence >= 0.75 and linked primary/strong Story evidence. Use confidence_profile=loose for exhaustive/raw retrieval. Use this for incident-level Conflict and CAMEO+ records with normalize…
- [Summarize Events](https://docs.gdeltcloud.com/api-reference/v2-endpoints/events/summarize-events.md): Return dashboard-ready Event rollups by date, geography, category, or subcategory. By default, summaries use confidence_profile=precise, which filters to confidence >= 0.75 and linked primary/strong Story evidence. Use confidence_profile=loose for exhaustive/raw rollups. Use this before drilling int…
- [List Admin1 Values](https://docs.gdeltcloud.com/api-reference/v2-endpoints/geography/list-admin1-values.md): Discover valid state/province/admin1 values for one country. This endpoint is intentionally country-scoped and does not return the full admin1 catalog.
- [Get Story](https://docs.gdeltcloud.com/api-reference/v2-endpoints/stories/get-story.md): Fetch one known Story by ID with linked Events, linked Entities, metrics, public URL, normalized geo, and top 3 inline articles.
- [Get Story Articles](https://docs.gdeltcloud.com/api-reference/v2-endpoints/stories/get-story-articles.md): Fetch the full paginated source-article list for a Story. Use this when the top 3 inline articles are not enough.
- [Search Stories](https://docs.gdeltcloud.com/api-reference/v2-endpoints/stories/search-stories.md): Search clustered Stories for narrative and article evidence. By default, list results use confidence_profile=precise, which filters to primary/strong Story families and deduplicates obvious semantic duplicates before pagination. Use confidence_profile=loose for exhaustive/raw retrieval. Story cards…
- [Summarize Stories](https://docs.gdeltcloud.com/api-reference/v2-endpoints/stories/summarize-stories.md): Return dashboard-ready Story rollups by date, geography, category, or subcategory. By default, summaries use confidence_profile=precise, which filters to primary/strong Story families and deduplicates obvious semantic duplicates before aggregation. Use confidence_profile=loose for exhaustive/raw rol…
- [Authentication](https://docs.gdeltcloud.com/authentication.md): Learn about authentication methods for GDELT Cloud
- [API Keys](https://docs.gdeltcloud.com/developers/api-keys.md): Generate and manage API keys for programmatic access to the Developer API
- [Development](https://docs.gdeltcloud.com/development.md): Preview changes locally to update your docs
- [Conflict Data](https://docs.gdeltcloud.com/features/conflict-data.md): AI-coded political violence and protest events using the ACLED methodology
- [Event Coding: Conflict & CAMEO+](https://docs.gdeltcloud.com/features/event-coding.md): How GDELT Cloud generates structured Conflict and CAMEO+ Events from Story clusters.
- [Financial & Sanctions Risk](https://docs.gdeltcloud.com/guides/financial-sanctions-risk.md): Analyze sanctions, corridor stress, market context, and policy probabilities
- [General GDELT Cloud Workflow](https://docs.gdeltcloud.com/guides/general-task.md): Best practices for API v2 and MCP analyst workflows
- [Geopolitical Strategic Analysis](https://docs.gdeltcloud.com/guides/geopolitical-strategic-analysis.md): Use structured Events to trace trajectories, compare patterns, and avoid hindsight leakage
- [Location & Operational Risk Assessment](https://docs.gdeltcloud.com/guides/location-operational-risk.md): Evaluate countries, regions, and admin1 locations using v2 Events and Stories
- [Supply Chain Risk Intelligence](https://docs.gdeltcloud.com/guides/supply-chain-risk.md): Use Events, Stories, Entities, and market context to monitor supply-chain disruption
- [Welcome to GDELT Cloud](https://docs.gdeltcloud.com/index.md): Global news event analytics powered by AI
- [Authentication](https://docs.gdeltcloud.com/mcp/authentication.md): Authenticate with GDELT Cloud MCP server using API keys
- [GDELT Cloud Docs MCP](https://docs.gdeltcloud.com/mcp/docs-mcp.md): Connect AI agents to GDELT Cloud documentation via Model Context Protocol
- [ChatGPT](https://docs.gdeltcloud.com/mcp/integrations/chatgpt.md): Connect GDELT Cloud MCP to ChatGPT (web)
- [Claude](https://docs.gdeltcloud.com/mcp/integrations/claude.md): Connect GDELT Cloud MCP to Claude (web and desktop)
- [LangChain Integration](https://docs.gdeltcloud.com/mcp/integrations/langchain.md): Build LangChain and LangGraph agents with GDELT Cloud MCP
- [MCP Server Introduction](https://docs.gdeltcloud.com/mcp/introduction.md): Connect AI agents to GDELT Cloud v2 products and enrichment tools using the Model Context Protocol
- [gdelt_system_prompt](https://docs.gdeltcloud.com/mcp/prompts/system-prompt.md): System prompt for analyst-grade GDELT Cloud MCP agents
- [MCP Quickstart](https://docs.gdeltcloud.com/mcp/quickstart.md): Connect to GDELT Cloud MCP and call the v2 Progressive Discovery catalog
- [Code And Metric Reference](https://docs.gdeltcloud.com/mcp/resources/codes.md): CAMEO, Conflict, CAMEO+, and Goldstein references for GDELT Cloud v2
- [financial-sanctions-risk](https://docs.gdeltcloud.com/mcp/skills/financial-sanctions-risk.md): Sanctions contagion, corridor stress, macro-finance, prediction-market, and structured Event evidence
- [general-task](https://docs.gdeltcloud.com/mcp/skills/general-task.md): Baseline GDELT Cloud analyst workflow using v2 Events, Stories, Entities, and enrichment tools
- [geopolitical-strategic-analysis](https://docs.gdeltcloud.com/mcp/skills/geopolitical-strategic-analysis.md): Strategic windows, escalation trajectories, actor posture, and non-obvious geopolitical patterns
- [Skills Overview](https://docs.gdeltcloud.com/mcp/skills/index.md): Domain-specific workflow guides for GDELT Cloud analytical tasks
- [location-operational-risk](https://docs.gdeltcloud.com/mcp/skills/location-operational-risk.md): Location risk briefs across security, infrastructure, labor, regulation, environment, and market context
- [supply-chain-risk](https://docs.gdeltcloud.com/mcp/skills/supply-chain-risk.md): Supply-chain disruption analysis anchored in Events, Stories, macro data, prediction markets, and web corroboration
- [External Enrichment Tools](https://docs.gdeltcloud.com/mcp/tools/external-tools.md): Complete MCP parameter reference for macro finance, prediction markets, and web research
- [GDELT Cloud v2 MCP Tools](https://docs.gdeltcloud.com/mcp/tools/gdelt-cloud.md): Complete MCP parameter reference for generated Events, Stories, Entities, and geo discovery
- [Progressive Discovery](https://docs.gdeltcloud.com/mcp/tools/progressive-discovery.md): How agents discover, inspect, and call GDELT Cloud MCP tools
- [Quickstart](https://docs.gdeltcloud.com/quickstart.md): Get started with GDELT Cloud v2, REST API, and MCP

## OpenAPI Specs

- [openapi-v2](https://docs.gdeltcloud.com/api-reference/openapi-v2.json)
- [openapi](https://docs.gdeltcloud.com/api-reference/openapi.json)
- [openapi-media-events](https://docs.gdeltcloud.com/api-reference/openapi-media-events.json)
- [openapi-entities](https://docs.gdeltcloud.com/api-reference/openapi-entities.json)
- [openapi-domains](https://docs.gdeltcloud.com/api-reference/openapi-domains.json)
- [openapi-conflict-events](https://docs.gdeltcloud.com/api-reference/openapi-conflict-events.json)
- [openapi-cameoplus-events](https://docs.gdeltcloud.com/api-reference/openapi-cameoplus-events.json)