{ "openapi": "3.0.1", "info": { "title": "Federal Contract Award Alerts – New Awards Only", "description": "Get only newly signed U.S. federal contract awards by NAICS, PSC, agency, set-aside or state, with offers received and competition data.", "version": "1.0", "x-build-id": "f4naXxmsz088XUanz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/keyboardhacker~federal-contract-award-alerts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-keyboardhacker-federal-contract-award-alerts", "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/keyboardhacker~federal-contract-award-alerts/runs": { "post": { "operationId": "runs-sync-keyboardhacker-federal-contract-award-alerts", "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/keyboardhacker~federal-contract-award-alerts/run-sync": { "post": { "operationId": "run-sync-keyboardhacker-federal-contract-award-alerts", "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": "Industry codes (2–6 digits). A shorter code matches every code under it, e.g. 5415 = all computer systems design services.", "items": { "type": "string" } }, "pscCodes": { "title": "Product / service codes (PSC)", "type": "array", "description": "Federal product and service codes, e.g. D399 (other IT and telecom services) or R408 (program management support).", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Words or phrases matched against award descriptions and recipient names, e.g. \"cybersecurity\".", "items": { "type": "string" } }, "awardingAgencies": { "title": "Awarding agencies", "type": "array", "description": "Top-level agency names exactly as USAspending writes them, e.g. \"Department of Defense\", \"Department of Veterans Affairs\". Note: Department of Defense awards are published 30–90 days after signing; incremental mode still delivers them when they appear.", "items": { "type": "string" } }, "setAsideTypes": { "title": "Set-aside type codes", "type": "array", "description": "Only awards under these small-business set-asides, e.g. SBA (total small business), 8A, 8AN, SDVOSBC (service-disabled veteran-owned), WOSB (women-owned). Leave empty for all.", "items": { "type": "string" } }, "placeOfPerformanceStates": { "title": "Place-of-performance states", "type": "array", "description": "Two-letter U.S. state codes where the work is performed, e.g. VA, MD, TX.", "items": { "type": "string" } }, "minAwardAmount": { "title": "Minimum award amount (USD)", "minimum": 0, "type": "integer", "description": "Skip awards below this obligated amount." }, "maxAwardAmount": { "title": "Maximum award amount (USD)", "minimum": 0, "type": "integer", "description": "Skip awards above this obligated amount." }, "lookbackDays": { "title": "Look back (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Awards signed within this many days are returned (on the first incremental run, or on every run when incremental mode is off). Ignored when \"Signed on or after\" is set.", "default": 7 }, "dateFrom": { "title": "Signed on or after (optional)", "type": "string", "description": "Fixed start date (YYYY-MM-DD) for a one-off historical pull instead of a rolling window." }, "maxResults": { "title": "Maximum awards per run", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard cap on awards delivered (and charged) per run. Your run's maximum-charge setting is also respected.", "default": 200 }, "enrichDetails": { "title": "Add competition and contract details", "type": "boolean", "description": "Adds NAICS/PSC, set-aside, extent competed, number of offers received, solicitation ID, parent contract vehicle, recipient UEI and parent company, potential total value and place of performance. Slower (one extra official API call per award); the price per award is the same.", "default": true }, "incremental": { "title": "Only new awards since my last run", "type": "boolean", "description": "Remembers which awards this feed already delivered and never returns (or charges for) them again — including awards the source publishes late (Department of Defense data appears 30–90 days after signing). TURN THIS ON FOR SCHEDULED MONITORING. Off: every run returns everything signed in the window.", "default": false }, "feedName": { "title": "Feed name (optional)", "type": "string", "description": "Only needed if you want two independent incremental feeds with identical filters (e.g. one per team or integration). Each feed name keeps its own memory of delivered awards." } } }, "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 } } } } } } } } } }