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 "X-API-Key: lf_live_your_key_here" \
  "https://api.lumafeed.com/v1/events?min_score=7&size=5"

Authentication

All API requests require an API key passed via the X-API-Key header. Get your API key from the Dashboard.

HTTP Header

X-API-Key: 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
event_id	string	Unique event identifier (e.g. evt_20260330_001)
event_title	string	Human-readable event headline
event_type	string	Type of event (investment, acquisition, ipo, merger)
deal_type	string	Deal classification (e.g. funding)
deal_amount	integer\|null	Deal amount in USD (e.g. 200000000) or null if undisclosed
funding_round	string\|null	Funding round (seed, a, b, c, d, etc.)
importance_score	integer	Importance score 0-10 based on deal size, investor quality, and news volume
industry	string	Primary industry classification (e.g. artificial_intelligence)
sub_industry	string	Sub-industry classification (e.g. legal_tech)
companies	string (JSON)	JSON array of company objects with name and role fields
investors	string (JSON)	JSON array of investor objects with name and role fields
company_description	string	Short description of the company
news_count	integer	Number of independent news sources reporting this event
first_seen_at	string	ISO 8601 timestamp when the event was first detected
created_at	string	ISO 8601 timestamp when the record was created
region_tags	string (JSON)	JSON array of region codes (e.g. ["US"])
deal_tags	string (JSON)	JSON array of deal tags (e.g. ["mega-deal"])

Examples

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

bash

curl -H "X-API-Key: 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 "X-API-Key: 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 "X-API-Key: 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/:event_id

Path Parameters

Parameter	Type	Description
event_id	string	The unique event ID (e.g. evt_20260330_001). Required.

Example

bash

curl -H "X-API-Key: lf_live_your_key_here" \
  "https://api.lumafeed.com/v1/events/evt_20260330_001"

Response

JSON

{
  "event": {
    "event_id": "evt_20260330_001",
    "event_title": "Harvey raises $200M",
    "event_type": "investment",
    "deal_amount": 200000000,
    "funding_round": "d",
    "industry": "artificial_intelligence",
    "importance_score": 9,
    ...
  },
  "related_news": [
    {
      "title": "Harvey raises $200M...",
      "url": "https://...",
      "source": "TechCrunch",
      "published_at": "2026-03-30T08:00:00Z"
    }
  ]
}

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 "X-API-Key: lf_live_your_key_here" \
  "https://api.lumafeed.com/v1/summary?date=2026-03-30"

Summary for US region only:

bash

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

Response Format

All responses are JSON. Successful list responses include a data array along with total, page, and size fields for pagination.

JSON

{
  "data": [
    {
      "event_id": "evt_20260330_001",
      "event_title": "Harvey raises $200M",
      "event_type": "investment",
      "deal_type": "funding",
      "deal_amount": 200000000,
      "funding_round": "d",
      "industry": "artificial_intelligence",
      "sub_industry": "legal_tech",
      "importance_score": 9,
      "companies": "[{\"name\":\"Harvey\",\"role\":\"issuer\"}]",
      "investors": "[{\"name\":\"Sequoia\",\"role\":\"lead\"}]",
      "company_description": "AI-powered legal platform...",
      "news_count": 7,
      "first_seen_at": "2026-03-30T08:15:00Z",
      "created_at": "2026-03-30T08:20:00Z",
      "region_tags": "[\"US\"]",
      "deal_tags": "[\"mega-deal\"]"
    }
  ],
  "total": 45,
  "page": 1,
  "size": 20
}

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

Check your remaining quota via the /me endpoint, which returns your plan limits and today's usage.

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."
  }
}