{ "openapi": "3.0.1", "info": { "title": "Federal Awards & Spending Lookup (USAspending.gov)", "description": "Search U.S. Treasury USAspending.gov for federal contracts, grants, loans, direct payments, and IDVs by recipient name. Returns normalized award records with amounts, agency, dates, UEI, and source links. No API key. B2G sales intelligence and vendor due-diligence.", "version": "0.1", "x-build-id": "u3DlIDJqqgTve3OBN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/whetstonetools~federal-awards-lookup/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-whetstonetools-federal-awards-lookup", "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/whetstonetools~federal-awards-lookup/runs": { "post": { "operationId": "runs-sync-whetstonetools-federal-awards-lookup", "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/whetstonetools~federal-awards-lookup/run-sync": { "post": { "operationId": "run-sync-whetstonetools-federal-awards-lookup", "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": { "recipientName": { "title": "Recipient name", "type": "string", "description": "Company or organization name to search for in the federal awards database (USAspending.gov). Partial names are supported — the API uses fuzzy matching. Optional if you supply at least one of NAICS codes, awarding agencies, or place-of-performance states below." }, "naicsCodes": { "title": "NAICS codes (non-name search)", "uniqueItems": true, "type": "array", "description": "Filter by one or more NAICS industry codes (e.g. 541511 = Custom Computer Programming Services). Can be used with or instead of a recipient name.", "items": { "type": "string" } }, "awardingAgencies": { "title": "Awarding agencies (non-name search)", "uniqueItems": true, "type": "array", "description": "Filter by one or more top-level awarding agency names, exactly as USAspending labels them (e.g. \"Department of Defense\", \"Department of Health and Human Services\"). Can be used with or instead of a recipient name.", "items": { "type": "string" } }, "placeOfPerformanceStates": { "title": "Place-of-performance states (non-name search)", "uniqueItems": true, "type": "array", "description": "Filter by 2-letter U.S. state code(s) where the work is performed (e.g. MS, TX, CA). Can be used with or instead of a recipient name.", "items": { "type": "string" } }, "awardTypes": { "title": "Award types to include", "type": "array", "description": "Which categories of federal awards to return. Each category is queried separately (USAspending requires same-group codes per request) and merged. Defaults to all.", "items": { "type": "string", "enum": [ "contracts", "grants", "loans", "direct_payments", "idvs", "other_financial_assistance" ], "enumTitles": [ "Contracts (A/B/C/D)", "Grants (02-05)", "Loans (07/08)", "Direct Payments (06/10)", "IDVs / Indefinite Delivery Vehicles", "Other Financial Assistance (09/11)" ] }, "default": [ "contracts", "grants", "loans", "direct_payments", "idvs", "other_financial_assistance" ] }, "includeSubawards": { "title": "Include sub-awards", "type": "boolean", "description": "Also return sub-award (prime → subcontractor / subrecipient) records for the same filters. Sub-awards are fetched with their own result budget (up to Max results) and are tagged recordType=\"subaward\" with primeAwardId / primeRecipientName populated.", "default": false }, "includeRecipientHierarchy": { "title": "Include recipient corporate hierarchy", "type": "boolean", "description": "Look up each recipient's corporate parent (parent UEI + parent name) via the USAspending recipient endpoint and add parentUei / parentName to prime-award records. Adds one API call per unique recipient, so it is off by default.", "default": false }, "sinceFiscalYear": { "title": "Since fiscal year", "minimum": 2008, "maximum": 2030, "type": "integer", "description": "Earliest federal fiscal year to include (FY starts Oct 1). Defaults to 5 years back. Minimum: 2008 (USAspending earliest reliable data)." }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum total prime-award records to return across all award types. Defaults to 50. Sub-awards (if enabled) have their own separate budget of the same size. Higher values increase run time and cost.", "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 } } } } } } } } } }