{ "openapi": "3.0.1", "info": { "title": "USAspending Federal Awards Monitor (Contracts & Grants)", "description": "Unofficial; not affiliated with USAspending.gov or Treasury. Search and monitor U.S. federal contract, IDV and grant awards via the official USAspending API. Filter by keyword, recipient, agency, NAICS, assistance listing, state, amount. Only-new results plus amount changes.", "version": "0.1", "x-build-id": "vf3coK8VGm9Q66o5G" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/brightish_ascent~usaspending-awards-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-brightish_ascent-usaspending-awards-monitor", "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/brightish_ascent~usaspending-awards-monitor/runs": { "post": { "operationId": "runs-sync-brightish_ascent-usaspending-awards-monitor", "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/brightish_ascent~usaspending-awards-monitor/run-sync": { "post": { "operationId": "run-sync-brightish_ascent-usaspending-awards-monitor", "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": "contracts = definitive contracts, purchase orders, delivery/task orders, BPA calls; idvs = indefinite delivery vehicles (GWACs, IDIQs, BPAs, FSS); grants = block, formula, project grants and cooperative agreements. Default: contracts and grants.", "items": { "type": "string", "enum": [ "contracts", "idvs", "grants" ], "enumTitles": [ "Contracts", "IDVs (indefinite delivery vehicles)", "Grants" ] } }, "keywords": { "title": "Keywords", "type": "array", "description": "Award keyword search (each 3-100 characters), e.g. cybersecurity. Matches USAspending's keyword index (description, recipient, ids and more).", "items": { "type": "string" } }, "recipientSearch": { "title": "Recipient name or UEI", "type": "string", "description": "Recipient name text or 12-character UEI (at least 3 characters)." }, "awardingAgencies": { "title": "Awarding agencies", "type": "array", "description": "Top-tier agency names or abbreviations, e.g. Department of Defense, DOD, NASA, NSF. Unknown names fail the run with a clear message.", "items": { "type": "string" } }, "naicsCodes": { "title": "NAICS codes (contracts/IDVs)", "type": "array", "description": "2-6 digit NAICS codes, e.g. 541512. Applies to contracts and IDVs only.", "items": { "type": "string" } }, "assistanceListings": { "title": "Assistance listings (grants)", "type": "array", "description": "Assistance Listing (CFDA) numbers, e.g. 47.084. Applies to grants only.", "items": { "type": "string" } }, "placeOfPerformanceStates": { "title": "Place of performance states", "type": "array", "description": "2-letter U.S. state codes, e.g. CO, VA.", "items": { "type": "string" } }, "minAmount": { "title": "Minimum award amount (USD)", "minimum": 0, "type": "number", "description": "Lower bound on the award amount (obligated total)." }, "maxAmount": { "title": "Maximum award amount (USD)", "minimum": 0, "type": "number", "description": "Upper bound on the award amount." }, "dateType": { "title": "Date field", "enum": [ "last_modified_date", "action_date" ], "type": "string", "description": "Which date fromDate/toDate filter on. Monitor mode requires last_modified_date.", "default": "last_modified_date" }, "fromDate": { "title": "From date", "type": "string", "description": "YYYY-MM-DD, on or after 2007-10-01. If fromDate and toDate are empty, the last 7 days are used." }, "toDate": { "title": "To date", "type": "string", "description": "YYYY-MM-DD. Default: tomorrow (UTC)." }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum rows per run (you pay per row). Default 25, max 1000.", "default": 25 }, "onlyNewSinceLastRun": { "title": "Only new or changed since last run", "type": "boolean", "description": "For schedules: return awards not delivered before with the same filters, plus delivered awards whose award amount, total outlays or end date changed (updateType \"changed\", with previous values). First run is a baseline.", "default": false }, "outputFormat": { "title": "Output format", "enum": [ "full", "compact" ], "type": "string", "description": "compact = key fields only, description cut to 300 characters.", "default": "full" } } }, "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 } } } } } } } } } }