APIv1

Granted Data API

Programmatic access to 85K+ grants and 133K foundations. RESTful endpoints, semantic search, and structured data for researchers, developers, and organizations.

Try Instantly REST API MCP Server

Copy & Paste

Give this prompt to your AI coding assistant:

Read https://grantedai.com/skill.md and build me an awesome grant search tool!

Works with Claude Code, Cursor, Codex, or any AI assistant. Includes an API key — start building in seconds.

Quick Start

Start making API calls right now — no signup required.

Use the anonymous API key

Copy this key to start immediately. 3 AI discovery searches/day, 50 requests/day.

Authorization: Bearer ga_live_c1eee54a9ad8753126b303aeafed3621dd563f67fcc77c74c8b150a028dc42ea

Run an AI-powered grant search

The /discover endpoint searches the web with multiple AI providers and returns scored results.

curl -H "Authorization: Bearer ga_live_c1eee54a9ad8753126b303aeafed3621dd563f67fcc77c74c8b150a028dc42ea" \
  "https://grantedai.com/api/v1/discover?q=climate+adaptation&state=CA&limit=5"

Parse the response

Grants are scored by relevance (fit_score), with deadlines, amounts, and application links.

{
  "data": [
    {
      "name": "Climate Resilience Planning Grant",
      "funder": "California Governor's Office",
      "fit_score": 82,
      "deadline": "June 15, 2026",
      "amount": "$200,000 - $1,500,000",
      "summary": "Supports community-led climate adaptation...",
      "rfp_url": "https://...",
      "match_reasons": ["Matches your focus: climate", "Available in California"],
      "details_url": "https://grantedai.com/grants/..."
    }
  ],
  "meta": {
    "total": 28,
    "cache_hit": false,
    "ai_searches_used": 1,
    "ai_searches_limit": 3
  }
}

Want more? Create a free account to get your own API key with 10 AI searches/day and 100 requests/day.

Create Free Account

Authentication

All API requests require an API key in the Authorization header.

Authorization: Bearer ga_live_YOUR_API_KEY

Anonymous access: Use the shared anonymous key above to start immediately. Limited to 3 AI discovery searches and 50 requests per day per IP.

Registered access: Create a free account to get your own API key with higher limits (10 AI searches/day, 100 requests/day). Rate limits are enforced per key on a rolling 24-hour window.

The current limit is returned in the X-RateLimit-Limit response header.

API Endpoints

All endpoints are prefixed with the base URL and require authentication.

GET/api/v1/grants

Search and list grants with filters

Parameters

q, status, funder, state, amount_min, amount_max, deadline_before, deadline_after, tags, offset, limit, sort

Example

https://grantedai.com/api/v1/grants?status=active&state=CA&limit=5

GET/api/v1/grants/:id

Get a single grant by ID

Example

https://grantedai.com/api/v1/grants/abc-123

GET/api/v1/foundations

Search and list foundations with filters

Parameters

q, state, ntee, assets_min, assets_max, giving_min, giving_max, offset, limit, sort

Example

https://grantedai.com/api/v1/foundations?state=NY&giving_min=1000000&sort=giving_desc

GET/api/v1/foundations/:id

Get foundation detail with financials and key people

Example

https://grantedai.com/api/v1/foundations/abc-123

GET/api/v1/foundations/:id/grants

List grants given by a foundation

Parameters

q, year_min, year_max, amount_min, amount_max, offset, limit, sort

Example

https://grantedai.com/api/v1/foundations/abc-123/grants?year_min=2022

GET/api/v1/search

Semantic search across grants and foundations (embedding-based)

Parameters

q (required), type (grants/foundations/all), limit, state

Example

https://grantedai.com/api/v1/search?q=climate+change+adaptation&type=all&limit=10

GET/api/v1/discover

AI-powered grant discovery — live web search across multiple LLM providers, blended with database results and scored by relevance

Parameters

q (required), state, source (federal/state/international/foundation), funder, org_type, include_historical, limit

Example

https://grantedai.com/api/v1/discover?q=watershed+restoration&state=CA&limit=10

MCP Server

Connect Granted directly to Claude Desktop, Cursor, or any MCP-compatible AI assistant.

Granted exposes a Model Context Protocol (MCP) server so AI assistants can search grants, research funders, and analyze competitive landscapes on your behalf. The same AI-powered discovery pipeline that runs on grantedai.com — including live web search across multiple LLM providers — is available through MCP.

Available Tools

search_grants

AI-powered search across 85K+ grants with live web discovery

get_grant

Full grant detail — eligibility, deadlines, application links

search_funders

Search 133K foundations by name, state, assets, giving

get_funder

Foundation profile with financials, recent grants, officers

get_past_winners

Competitive intel — who won federal grant programs

Claude Desktop Setup

Add this to your Claude Desktop config file (claude_desktop_config.json):

{
  "mcpServers": {
    "granted": {
      "type": "url",
      "url": "https://grantedai.com/api/mcp/mcp"
    }
  }
}

No API key required (free tier)5 tools · 4 resourcesRead-only · No auth needed

Response Format

All responses use a consistent JSON envelope.

Success Response

{
  "data": [ ... ],
  "meta": {
    "total": 1247,
    "offset": 0,
    "limit": 20
  }
}

Error Response

{
  "error": {
    "message": "Rate limit exceeded",
    "status": 429
  }
}

Pagination

List endpoints support offset-based pagination.

Parameter	Type	Default	Description
offset	integer	0	Number of results to skip
limit	integer	20	Results per page (max 100)

# Page 1
GET /api/v1/grants?offset=0&limit=20

# Page 2
GET /api/v1/grants?offset=20&limit=20

# Page 3
GET /api/v1/grants?offset=40&limit=20

Rate Limits

Free tiers use daily limits. Paid tiers (Starter, Growth, Enterprise) use monthly billing cycles.

Tier	AI Searches	DB Queries	Period
Anonymous	3/day	50/day per IP	Daily
Free	10/day	100/day	Daily
Starter ($149/mo)	500/month	25,000/month	Monthly
Growth ($499/mo)	2,000/month	100,000/month	Monthly
Enterprise	10,000+/month	Unlimited	Monthly

AI searches count only on cache misses to /api/v1/discover. Cache hits are free and unlimited. When the AI limit is exhausted, the endpoint gracefully falls back to database-only results.

Response Header	Description
X-Api-Tier	Your current tier
X-RateLimit-Limit	Daily request quota (free tiers only)
X-RateLimit-DB-Queries-Used	Monthly DB queries used (paid tiers)
X-RateLimit-DB-Queries-Limit	Monthly DB query limit (paid tiers)
X-RateLimit-AI-Searches-Used	Monthly AI searches used (paid tiers)
X-RateLimit-AI-Searches-Limit	Monthly AI search limit (paid tiers)
X-RateLimit-Period-Reset	ISO 8601 date when monthly counters reset (paid tiers)

API Pricing

Start free, upgrade as you grow.

Anonymous

50 requests/day per IP

✓Instant access — no signup
✓All grant & foundation data
✓3 AI discovery searches/day
✓Shared API key

Use Now

Free

$0/month

100 requests/day

✓Your own API key
✓All grant & foundation data
✓Semantic search
✓10 AI discovery searches/day
✓Community support

Get Started

Popular

Starter

$149/month

25,000 queries/month

✓Everything in Free
✓500 AI discovery searches/month
✓25,000 DB queries/month
✓Monthly usage headers
✓Foundation financials
✓Priority support

Growth

$499/month

100,000 queries/month

✓Everything in Starter
✓2,000 AI discovery searches/month
✓100,000 DB queries/month
✓Key people data
✓Dedicated support

Enterprise

Custom

Unlimited

✓Everything in Growth
✓10,000+ AI searches/month
✓Unlimited DB queries
✓Bulk data exports
✓Custom datasets
✓Dedicated support & SLA

Contact Sales

Data Coverage

What data is available through the API.

Grant Opportunities

85K+

Private Foundations

133K

Foundation Grants

Millions

Key People

79K+

Data Fields

Grants

Name, funder, summary, eligibility
Amount range (min/max)
Deadline, status (active/closed)
State, agency, program, CFDA number
Tags, source URL

Foundations

Name, EIN, NTEE code, state, city
Mission, programs, website
Asset amount, total giving
Financial history (10 years)
Key people with compensation
Application info (deadline, restrictions)
Individual grants given (recipient, amount, purpose)

Academic Access

Free Pro tier access for researchers at accredited institutions.

Researchers and students at accredited educational institutions can apply for free Pro-tier API access. Email us with your institutional email address and a brief description of your research.

Apply for Academic Access

Ready to start your proposal?

Granted drafts, reviews, and strengthens your grant application — saving weeks of work. Win a grant in 12 months or get a full refund.

Browse More Grants

Backed by the Granted Guarantee — win a grant or get a full refund.