🐟

GrantScope.ai

API Documentation

Complete reference for the GrantScope AI API

Introduction

Welcome to the GrantScope AI API documentation. Our API provides programmatic access to grant discovery, AI-powered analysis, and funding management features.

Base URL: https://api.grantscope.ai/v1

Authentication

All API requests require authentication using a JWT token. Include your token in the Authorization header:

Authorization: Bearer YOUR_JWT_TOKEN

To obtain a JWT token, authenticate via the login endpoint:

POST /api/auth/login

Authenticate user and receive JWT token

API Endpoints

Grants

GET /api/grants

Retrieve all grants with optional filtering

Query Parameters:

page - Page number (default: 1)
limit - Items per page (default: 20)
agency - Filter by agency name
min_funding - Minimum funding amount
deadline_after - Grants with deadline after date (YYYY-MM-DD)

Response Example:

{ "grants": [ { "id": 1, "title": "Innovation Research Grant", "agency": "National Science Foundation", "funding_amount": 500000, "deadline": "2025-12-31", "description": "Grant for innovative research projects..." } ], "total": 150, "page": 1, "pages": 8 }
GET /api/grants/{id}

Retrieve detailed information about a specific grant

Alerts

GET /api/alerts

Get all alerts for the authenticated user

POST /api/alerts

Create a new grant alert

Request Body:

{ "name": "AI Research Alerts", "keywords": "artificial intelligence, machine learning", "agencies": "NSF, NIH", "min_funding": 100000, "frequency": "daily" }

Startup Profiles

GET /api/profile

Get current user's startup profile

PUT /api/profile

Update startup profile information

Request Body:

{ "company_name": "TechStartup Inc", "industry": "AI/ML", "description": "AI-powered solutions for healthcare", "employee_count": 10, "funding_stage": "Seed", "location": "San Francisco, CA" }

Grant Analysis

POST /api/grants/{id}/analyze

Get AI-powered analysis of grant fit and requirements

Response includes:

  • Eligibility score and assessment
  • Requirements breakdown and checklist
  • Success factors and tips
  • Competitive landscape analysis
  • Application timeline recommendations
  • Personalized application outline

Error Codes

400 Bad Request - Invalid parameters
401 Unauthorized - Invalid or missing token
403 Forbidden - Insufficient permissions
404 Not Found - Resource not found
429 Too Many Requests - Rate limit exceeded
500 Internal Server Error

Rate Limits

API rate limits are enforced to ensure fair usage and system stability:

Free Tier: 100 requests per hour
Pro Tier: 1,000 requests per hour
Max Tier: 10,000 requests per hour

Rate limit information is included in response headers:

X-RateLimit-Limit: 1000 X-RateLimit-Remaining: 999 X-RateLimit-Reset: 1640995200