{ "openapi": "3.0.1", "info": { "title": "Grants.gov Scraper & Grant Finder API: NSF, NIH Fellowships", "description": "Federal grant and fellowship alerts from official Grants.gov, NSF Award Search and NIH RePORTER APIs. Filter by keyword, agency, eligibility, category and deadline window. Normalized, deduplicated rows, new-since-last-run mode and 30/7-day deadline alerts.", "version": "0.1", "x-build-id": "GexGYY1lIQcYXv4e1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/clearfeedlabs~grant-fellowship-radar/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-clearfeedlabs-grant-fellowship-radar", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/clearfeedlabs~grant-fellowship-radar/runs": { "post": { "operationId": "runs-sync-clearfeedlabs-grant-fellowship-radar", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/clearfeedlabs~grant-fellowship-radar/run-sync": { "post": { "operationId": "run-sync-clearfeedlabs-grant-fellowship-radar", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "keywords": { "title": "Keywords / field", "type": "array", "description": "Research field or topic words, e.g. 'graduate fellowship', 'neuroscience', 'climate'. Each keyword is searched separately and results are merged and deduplicated; matchedKeywords shows which hit. Empty = everything (use filters).", "items": { "type": "string" } }, "strictKeywords": { "title": "Strict keyword match", "type": "boolean", "description": "Grants.gov keyword search is broad (any word). When on, an opportunity is kept only if every word of a keyword appears in its title, synopsis or eligibility text.", "default": true }, "sources": { "title": "Sources", "type": "array", "description": "Opportunities = money you can apply for. Awards = who just got funded (find labs, advisors, collaborators and active programs).", "items": { "type": "string", "enum": [ "grantsgov", "nsf", "nih" ], "enumTitles": [ "Grants.gov open & forecasted opportunities (all agencies incl. NSF, NIH)", "NSF recent awards", "NIH RePORTER recent awards" ] }, "default": [ "grantsgov", "nsf", "nih" ] }, "mode": { "title": "Mode", "enum": [ "all", "sinceLastRun" ], "type": "string", "description": "Since last run delivers each opportunity or award once (per stateKey), re-delivers it if its deadline/status changes, and (with the deadline-alert add-on) adds an alert row when a saved opportunity nears its deadline.", "default": "all" }, "deadlineWithinDays": { "title": "Deadline within (days)", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Only opportunities that close within this many days. Empty = any future deadline." }, "minDaysLeft": { "title": "At least this many days left", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Skip deadlines too soon to apply for, e.g. 14." }, "includeNoDeadline": { "title": "Include rolling / no-deadline opportunities", "type": "boolean", "description": "Forecasts and rolling programs often have no close date.", "default": true }, "enableDeadlineAlerts": { "title": "Add-on: deadline alerts ($0.005 each)", "type": "boolean", "description": "In since-last-run mode, emit a deadline-alert row when an opportunity you already received crosses a threshold below (default 30 and 7 days). Each alert costs $0.005.", "default": false }, "deadlineAlertDays": { "title": "Deadline alert thresholds (days)", "type": "array", "description": "Thresholds for the optional deadline-alert add-on.", "default": [ "30", "7" ], "items": { "type": "string" } }, "addPastWinners": { "title": "Add-on: past winners for NIH opportunities ($0.003 each)", "type": "boolean", "description": "For NIH funding opportunities (PAR-, RFA-, PA- numbers), attach who already won awards under that same opportunity in NIH RePORTER: project count, median award, top institutions and example projects. Charged only for rows where winners are found.", "default": false }, "agencies": { "title": "Agency codes (Grants.gov)", "type": "array", "description": "e.g. NSF, HHS-NIH11 (NIH), DOE, NASA, USDA-NIFA, ED, DOD. Top-level codes include their sub-agencies.", "items": { "type": "string" } }, "eligibilities": { "title": "Applicant eligibility", "type": "array", "description": "Grants.gov applicant types. Grad students usually apply through a university (20, 06) or as Individuals (21).", "items": { "type": "string", "enum": [ "21", "20", "06", "12", "13", "23", "22", "00", "01", "02", "04", "05", "07", "08", "11", "25", "99" ], "enumTitles": [ "Individuals", "Private institutions of higher education", "Public/State institutions of higher education", "Nonprofits 501(c)(3)", "Nonprofits without 501(c)(3)", "Small businesses", "For-profits (not small business)", "State governments", "County governments", "City/township governments", "Special district governments", "Independent school districts", "Native American tribal governments", "Public housing authorities", "Native American tribal organizations", "Others (see text)", "Unrestricted" ] } }, "fundingCategories": { "title": "Funding categories", "type": "array", "description": "Grants.gov funding activity categories.", "items": { "type": "string", "enum": [ "ST", "HL", "ED", "ENV", "EN", "AG", "AR", "HU", "NR", "IS", "CD", "BC", "ELT", "FN", "ISS", "LJL", "T", "DPR", "HO", "RD", "CP", "RT", "O" ], "enumTitles": [ "Science & Technology / R&D", "Health", "Education", "Environment", "Energy", "Agriculture", "Arts", "Humanities", "Natural Resources", "Information & Statistics", "Community Development", "Business & Commerce", "Employment & Training", "Food & Nutrition", "Income Security & Social Services", "Law & Justice", "Transportation", "Disaster Relief", "Housing", "Regional Development", "Consumer Protection", "Recreation & Tourism", "Other" ] } }, "fundingInstruments": { "title": "Funding instruments", "type": "array", "description": "Empty = all.", "items": { "type": "string", "enum": [ "G", "CA", "PC", "O" ], "enumTitles": [ "Grant", "Cooperative agreement", "Procurement contract", "Other" ] } }, "opportunityStatuses": { "title": "Opportunity status", "type": "array", "description": "Posted = open now. Forecasted = coming soon.", "items": { "type": "string", "enum": [ "posted", "forecasted", "closed", "archived" ] }, "default": [ "posted", "forecasted" ] }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Only opportunities posted recently (Grants.gov date filter)." }, "minAwardUsd": { "title": "Minimum award (USD)", "minimum": 0, "type": "integer", "description": "Opportunities: award ceiling at least this (unknown ceilings kept). Awards: amount at least this." }, "awardsLookbackDays": { "title": "Awards lookback (days)", "minimum": 1, "maximum": 730, "type": "integer", "description": "NSF/NIH awards made in the last N days. NSF publishes with a lag of several weeks.", "default": 60 }, "awardStates": { "title": "Award recipient states", "type": "array", "description": "Two-letter codes, e.g. CA, MA (NSF/NIH awards only).", "items": { "type": "string" } }, "nihInstitutes": { "title": "NIH institutes", "type": "array", "description": "e.g. NCI, NIMH, NIGMS, NHLBI (NIH awards only).", "items": { "type": "string" } }, "includeDetails": { "title": "Fetch full opportunity details", "type": "boolean", "description": "Adds award floor/ceiling, total funding, eligibility, description and links (one extra official API call per opportunity).", "default": true }, "includeAbstracts": { "title": "Long descriptions / abstracts", "type": "boolean", "description": "Longer synopsis text and NIH abstracts.", "default": false }, "maxItems": { "title": "Max rows", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Cap on rows (and cost) per run.", "default": 200 }, "stateKey": { "title": "State key", "type": "string", "description": "Separate watchlists keep separate since-last-run memory.", "default": "default" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }