{ "openapi": "3.0.1", "info": { "title": "USAspending Federal Awards Scraper & Monitor", "description": "Search and monitor US federal contract, IDV, grant, loan and payment awards from the official USAspending.gov API. Filter by keyword, recipient, agency, NAICS, PSC, ALN, state, amount, dates. Monitor mode returns only new or changed awards. No key. $0.002/award.", "version": "1.0", "x-build-id": "36LsEYKY27VR5BeWo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kempt_horizon_yzk~usaspending-awards/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kempt_horizon_yzk-usaspending-awards", "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/kempt_horizon_yzk~usaspending-awards/runs": { "post": { "operationId": "runs-sync-kempt_horizon_yzk-usaspending-awards", "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/kempt_horizon_yzk~usaspending-awards/run-sync": { "post": { "operationId": "run-sync-kempt_horizon_yzk-usaspending-awards", "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 award types to search.", "items": { "type": "string", "enum": [ "contracts", "idvs", "grants", "loans", "direct_payments", "other" ], "enumTitles": [ "Contracts (definitive, purchase orders, delivery/task orders, BPA calls)", "IDVs (GWACs, IDIQs, BPAs, FSS)", "Grants and cooperative agreements", "Loans", "Direct payments", "Other financial assistance" ] }, "default": [ "contracts" ] }, "keywords": { "title": "Keywords", "type": "array", "description": "Optional. Matches award descriptions, recipient names and other text fields.", "items": { "type": "string" } }, "recipientNames": { "title": "Recipient name or UEI", "type": "array", "description": "Optional. Company or organization names (partial match) or UEIs, e.g. Booz Allen, Leidos.", "items": { "type": "string" } }, "awardingAgencies": { "title": "Awarding agencies", "type": "array", "description": "Optional top-tier agency names exactly as on USAspending, e.g. Department of Veterans Affairs, Department of Homeland Security, General Services Administration.", "items": { "type": "string" } }, "naicsCodes": { "title": "NAICS codes", "type": "array", "description": "Optional (contracts/IDVs). 2 to 6 digits; shorter codes include all children, e.g. 5415.", "items": { "type": "string" } }, "pscCodes": { "title": "PSC codes", "type": "array", "description": "Optional (contracts/IDVs). Product/Service Codes, e.g. D310, R425.", "items": { "type": "string" } }, "setAsideTypes": { "title": "Set-aside codes", "type": "array", "description": "Optional (contracts/IDVs), e.g. SBA, 8A, HZC, SDVOSBC, WOSB.", "items": { "type": "string" } }, "assistanceListings": { "title": "Assistance Listing (CFDA) numbers", "type": "array", "description": "Optional (grants/loans/payments), e.g. 93.837.", "items": { "type": "string" } }, "states": { "title": "Place of performance states", "type": "array", "description": "Optional two-letter state codes, e.g. VA, MD, TX.", "items": { "type": "string" } }, "minAmount": { "title": "Minimum award amount (USD)", "minimum": 0, "type": "integer", "description": "Optional." }, "maxAmount": { "title": "Maximum award amount (USD)", "minimum": 0, "type": "integer", "description": "Optional." }, "lastDays": { "title": "Activity in last N days", "minimum": 1, "type": "integer", "description": "Optional. Awards with an action in this window. Default window is the last 30 days. Note: DoD contract data is published with a 90-day delay." }, "dateFrom": { "title": "Action date from (YYYY-MM-DD)", "type": "string", "description": "Optional. Ignored when 'Activity in last N days' is set. Earliest 2007-10-01." }, "dateTo": { "title": "Action date to (YYYY-MM-DD)", "type": "string", "description": "Optional. Defaults to today." }, "sortBy": { "title": "Sort by", "enum": [ "lastModified", "amount" ], "type": "string", "description": "Result order.", "default": "lastModified" }, "maxItems": { "title": "Max awards", "minimum": 1, "type": "integer", "description": "Maximum awards to save (and pay for). Up to 10,000 per category per run.", "default": 100 }, "onlyNew": { "title": "Only new or changed since last run (monitor mode)", "type": "boolean", "description": "Remembers awards already returned for the same filters (or monitor name) in a key-value store. Returns only new awards and awards whose amount, outlays, end date or modification date changed.", "default": false }, "stateKey": { "title": "Monitor name", "type": "string", "description": "Optional name for the monitor state, so several schedules keep separate memories." } } }, "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 } } } } } } } } } }