{ "openapi": "3.0.1", "info": { "title": "USAspending Federal Contract Awards Watch", "description": "Scheduled monitor for new or modified US federal contract awards from the official USAspending API (no API key). Filter by NAICS, PSC, awarding agency, recipient name, award amount, and place of performance. Pairs with SAM.gov opportunity watches for govcon pipeline tracking.", "version": "0.1", "x-build-id": "6T3Skb9uWzBh5Ypgl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/socosupply~usaspending-awards-watch/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-socosupply-usaspending-awards-watch", "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/socosupply~usaspending-awards-watch/runs": { "post": { "operationId": "runs-sync-socosupply-usaspending-awards-watch", "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/socosupply~usaspending-awards-watch/run-sync": { "post": { "operationId": "run-sync-socosupply-usaspending-awards-watch", "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": { "naicsCodes": { "title": "NAICS codes", "type": "array", "description": "Include contract awards with these NAICS codes. Empty = any NAICS.", "items": { "type": "string" } }, "pscCodes": { "title": "PSC codes", "type": "array", "description": "Product Service Code filter. Empty = any PSC.", "items": { "type": "string" } }, "awardingAgencies": { "title": "Awarding agencies", "type": "array", "description": "Top-tier awarding agency names as in USAspending (e.g. Department of Veterans Affairs). Empty = any agency.", "items": { "type": "string" } }, "recipientSearchTerms": { "title": "Recipient search terms", "type": "array", "description": "Match awards where the recipient organization name contains any of these terms (official USAspending recipient_search_text filter).", "items": { "type": "string" } }, "keywords": { "title": "Description keywords", "type": "array", "description": "Match if any keyword appears in the award description or award ID (case-insensitive).", "items": { "type": "string" } }, "placeOfPerformanceStates": { "title": "Place of performance (states)", "type": "array", "description": "Two-letter US state codes where work is performed. Empty = any.", "items": { "type": "string" } }, "minAwardAmount": { "title": "Minimum award amount (USD)", "type": "number", "description": "0 = no minimum.", "default": 0 }, "maxAwardAmount": { "title": "Maximum award amount (USD)", "type": "number", "description": "0 = no maximum.", "default": 0 }, "modifiedWithinDays": { "title": "Modified within (days)", "type": "integer", "description": "Only include awards whose Last Modified Date on USAspending is within this many days (UTC). The API query window is sized to this range.", "default": 14 }, "maxResults": { "title": "Max results", "type": "integer", "description": "Stop after pushing this many award records (0 = unlimited).", "default": 0 }, "emitAll": { "title": "Emit all matching awards", "type": "boolean", "description": "If true, push every award matching filters (changeType will be new, updated, or unchanged). If false, only new or updated since the last run. The example input turns this on so a first run shows a sample; turn it off for scheduled monitoring.", "default": false } } }, "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 } } } } } } } } } }