{ "openapi": "3.0.1", "info": { "title": "USAspending Scraper — US Federal Contracts & Grants", "description": "Search every US federal contract, IDV, grant, loan and direct payment from the official USAspending.gov awards API. 6 award categories, 37 typed output fields incl. recipient UEI/address, NAICS/PSC, CFDA program and place of performance. Filter by agency, keyword, state, date range and amount.", "version": "0.1", "x-build-id": "wQPLpJp7RqHw4XE1V" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetchsmith~us-federal-awards-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetchsmith-us-federal-awards-scraper", "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/fetchsmith~us-federal-awards-scraper/runs": { "post": { "operationId": "runs-sync-fetchsmith-us-federal-awards-scraper", "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/fetchsmith~us-federal-awards-scraper/run-sync": { "post": { "operationId": "run-sync-fetchsmith-us-federal-awards-scraper", "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": { "awardCategories": { "title": "Award categories", "type": "array", "description": "Which kinds of federal awards to pull. Each category is fetched with its own query (the API refuses to mix contract and grant codes in one request), then merged into one dataset.", "items": { "type": "string", "enum": [ "contracts", "idvs", "grants", "direct_payments", "other_financial_assistance", "loans" ], "enumTitles": [ "Contracts (BPA calls, purchase/delivery orders, definitive contracts)", "IDVs (GWAC, IDC, FSS, BOA, BPA)", "Grants (block, formula, project, cooperative agreements)", "Direct payments", "Other financial assistance", "Loans (face value + subsidy cost instead of obligated amount)" ] }, "default": [ "contracts" ] }, "startDate": { "title": "Start date", "type": "string", "description": "Earliest award action date, YYYY-MM-DD. Defaults to one year ago. The API has no data before 2007-10-01, so earlier dates are clamped." }, "endDate": { "title": "End date", "type": "string", "description": "Latest award action date, YYYY-MM-DD. Defaults to today." }, "keywords": { "title": "Keywords", "type": "array", "description": "Free-text search across award description, recipient and agency. Multiple keywords are ORed by the API.", "items": { "type": "string" } }, "agencies": { "title": "Awarding agencies", "type": "array", "description": "Exact top-tier awarding agency names as USAspending spells them, e.g. \"Department of Energy\", \"Department of Defense\", \"National Aeronautics and Space Administration\". Abbreviations do not match.", "items": { "type": "string" } }, "placeOfPerformanceStates": { "title": "Place-of-performance states", "type": "array", "description": "Two-letter USPS state codes for where the work is performed, e.g. CA, TX.", "items": { "type": "string" } }, "recipientStates": { "title": "Recipient states", "type": "array", "description": "Two-letter USPS state codes for the recipient's own address, e.g. NY, VA.", "items": { "type": "string" } }, "minAwardAmount": { "title": "Minimum award amount (USD)", "minimum": 0, "type": "integer", "description": "Only return awards at or above this obligated amount." }, "maxAwardAmount": { "title": "Maximum award amount (USD)", "minimum": 0, "type": "integer", "description": "Only return awards at or below this obligated amount." }, "sortBy": { "title": "Sort by", "enum": [ "awardAmount", "lastModifiedDate", "startDate", "recipientName" ], "type": "string", "description": "Ordering of results within each category. Loans are sorted by loan value / issued date, which are their equivalents of amount / start date.", "default": "awardAmount" }, "order": { "title": "Sort order", "enum": [ "desc", "asc" ], "type": "string", "description": "Whether the sort field runs high-to-low (descending, e.g. biggest awards first) or low-to-high.", "default": "desc" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many awards in total (across all selected categories). You are only charged for awards actually returned.", "default": 100 }, "maxPagesPerCategory": { "title": "Max pages per category", "minimum": 1, "maximum": 200, "type": "integer", "description": "Safety cap on how deep to paginate each category (100 awards per page).", "default": 50 } } }, "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 } } }, "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 } } } } } } } } } }