LumaFeed API Documentation

Access real-time global startup funding data through a simple REST API.

Quick Start

Get your first funding events in under a minute.

bash

curl -H "Authorization: Bearer lf_live_your_key_here" \
  "https://api.lumafeed.com/v1/events?min_score=7&size=5"

Authentication

All API requests require a Bearer token in the Authorization header. Get your API key from the Dashboard.

HTTP Header

Authorization: Bearer lf_live_your_key_here

Keep your API key secret. Do not expose it in client-side code or public repositories.

List Events

Retrieve a list of funding events, sorted by most recent.

HTTP

GET https://api.lumafeed.com/v1/events

Query Parameters

Parameter	Type	Required	Default	Description
size	integer	No	20	Results per page. Min 1, max 100.
page	integer	No	1	Page number for pagination. Starts at 1.
min_score	integer	No	0	Minimum importance score (0-10). Higher scores indicate more significant events.
industry	string	No	-	Filter by industry. Values: AI, Fintech, Biotech, SaaS, E-commerce, Healthcare, Enterprise, Developer Tools, Cybersecurity, Climate, Crypto, Logistics, EdTech, Robotics.
region	string	No	-	Filter by region. Values: US, China, India, Israel, Singapore, UK, Europe.
event_type	string	No	-	Filter by event type. Values: Funding, Acquisition, IPO, Merger.
min_amount	integer	No	0	Minimum deal amount in USD. e.g. 10000000 for $10M+.
start_date	string	No	-	ISO 8601 date. Only return events after this date (e.g. 2026-03-01).
end_date	string	No	-	ISO 8601 date. Only return events before this date.
sort	string	No	latest	Sort order. Values: latest, score, amount.

Response Fields

Field	Type	Description
id	string	Unique event identifier (e.g. evt_abc123)
title	string	Human-readable event headline
score	integer	Importance score 0-10 based on deal size, investor quality, and news volume
amount	string\|null	Formatted deal amount (e.g. "$50M") or null if undisclosed
round	string\|null	Funding round (Seed, Series A, Series B, etc.)
industry	string	Primary industry classification
region	string	Geographic region of the company
investors	string[]	List of investor names
company_description	string	Short description of the company
summary	string	AI-generated summary of the event
source_count	integer	Number of independent news sources reporting this event
published_at	string	ISO 8601 timestamp when the event was first detected
sources	object[]	Array of source objects with title and url fields

Examples

Filter AI deals above $10M, sorted by score:

bash

curl -H "Authorization: Bearer lf_live_your_key_here" \
  "https://api.lumafeed.com/v1/events?min_score=7&size=5&industry=AI"

Get Fintech funding in India from March 2026:

bash

curl -H "Authorization: Bearer lf_live_your_key_here" \
  "https://api.lumafeed.com/v1/events?industry=Fintech&region=India&start_date=2026-03-01&sort=amount"

Get acquisitions only, page 2:

bash

curl -H "Authorization: Bearer lf_live_your_key_here" \
  "https://api.lumafeed.com/v1/events?event_type=Acquisition&page=2&size=10"

Error Response

JSON

{
  "error": {
    "code": 400,
    "message": "Invalid parameter: min_score must be between 0 and 10",
    "details": "Received value: 15"
  }
}

Event Detail

Get full details for a single funding event by ID. Returns all fields including the full list of source links.

HTTP

GET https://api.lumafeed.com/v1/events/:id

Path Parameters

Parameter	Type	Description
id	string	The unique event ID (e.g. evt_abc123). Required.

Example

bash

curl -H "Authorization: Bearer lf_live_your_key_here" \
  "https://api.lumafeed.com/v1/events/evt_abc123"

404 Error Response

JSON

{
  "error": {
    "code": 404,
    "message": "Event not found",
    "details": "No event exists with ID evt_invalid_id"
  }
}

Daily Summary

Get a summary of funding activity for a specific date. Returns top events, total deal volume, and industry breakdown.

HTTP

GET https://api.lumafeed.com/v1/summary

Query Parameters

Parameter	Type	Default	Description
date	string	today	ISO 8601 date (e.g. 2026-03-30). Defaults to today.
region	string	-	Optional region filter for the summary.

Example

bash

curl -H "Authorization: Bearer lf_live_your_key_here" \
  "https://api.lumafeed.com/v1/summary?date=2026-03-30"

Summary for US region only:

bash

curl -H "Authorization: Bearer lf_live_your_key_here" \
  "https://api.lumafeed.com/v1/summary?date=2026-03-30&region=US"

Response Format

All responses are JSON. Successful responses include a data field and a meta field.

JSON

{
  "data": [
    {
      "id": "evt_abc123",
      "title": "Acme AI raises $50M Series B",
      "score": 9,
      "amount": "$50M",
      "round": "Series B",
      "industry": "AI",
      "region": "US",
      "investors": ["Sequoia Capital", "a16z"],
      "company_description": "Enterprise AI platform...",
      "summary": "Acme AI has raised...",
      "source_count": 4,
      "published_at": "2026-03-30T10:00:00Z",
      "sources": [
        { "title": "TechCrunch", "url": "https://..." }
      ]
    }
  ],
  "meta": {
    "total": 142,
    "page": 1,
    "size": 20,
    "queries_remaining_today": 12
  },
  "attribution": "Data provided by LumaFeed (lumafeed.com)"
}

Rate Limits

Plan	Daily Limit	Data Window
Free	20 queries/day	Last 48 hours
Pro	1,000 queries/day	Full history
Enterprise	Unlimited	Full history

Rate limit info is included in the meta.queries_remaining_today field of every response.

MCP Setup

Use LumaFeed as an MCP server with Claude Desktop, Cursor, or any MCP-compatible AI client.

1. Add to your MCP config

JSON

{
  "mcpServers": {
    "lumafeed": {
      "command": "npx",
      "args": ["-y", "@anthropic/lumafeed-mcp"],
      "env": {
        "LUMAFEED_API_KEY": "lf_live_your_key_here"
      }
    }
  }
}

2. Use in conversation

Once connected, you can ask your AI assistant questions like:

"Show me the latest AI funding rounds above $10M"

"What are the top-scored funding events today?"

"Summarize Series A deals in healthcare this week"

Skill Setup

Add LumaFeed as an AI Skill for automatic funding intelligence.

YAML - Skill Definition

name: lumafeed
description: Query global startup funding events
api_key: lf_live_your_key_here
base_url: https://api.lumafeed.com/v1
tools:
  - name: search_funding
    description: Search recent funding events
    parameters:
      min_score: 7
      size: 10
      industry: optional
      region: optional

Error Codes

Code	Meaning	Action
400	Bad Request	Check query parameters
401	Unauthorized	Check your API key
403	Forbidden	Plan does not include this feature
429	Rate Limited	Daily quota exceeded, wait or upgrade
500	Server Error	Retry after a moment

Error Response Format

JSON

{
  "error": {
    "code": 429,
    "message": "Daily query limit exceeded",
    "details": "Free plan allows 20 queries per day. Upgrade to Pro for 1,000."
  }
}