{ "openapi": "3.0.1", "info": { "title": "Government Contract Scraper - USAspending", "description": "USAspending has no period-of-performance filter, and sorting by end date returns 1995 one way and 3017 the other. So you cannot ask which contracts expire soon. This computes it, flags the corrupt dates, and ranks expiring awards by value with incumbent, outlay rate and vendor concentration.", "version": "0.1", "x-build-id": "ToqCELRaQAIc043C7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datalayer~federal-contract-awards/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datalayer-federal-contract-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/datalayer~federal-contract-awards/runs": { "post": { "operationId": "runs-sync-datalayer-federal-contract-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/datalayer~federal-contract-awards/run-sync": { "post": { "operationId": "run-sync-datalayer-federal-contract-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": { "awardTypes": { "title": "Award types", "type": "array", "description": "Contracts are definitive awards. IDVs are the vehicles orders are placed against. Grants, loans and direct payments are assistance awards and carry CFDA numbers instead of NAICS.", "items": { "type": "string", "enum": [ "contracts", "idvs", "grants", "loans", "direct_payments", "other" ], "enumTitles": [ "Contracts", "IDVs (vehicles)", "Grants", "Loans", "Direct payments", "Other" ] }, "default": [ "contracts" ] }, "agency": { "title": "Awarding agency", "type": "string", "description": "Exact top-tier agency name, e.g. Department of Defense, Department of Veterans Affairs. Leave empty for all.", "default": "" }, "keywords": { "title": "Keywords", "type": "array", "description": "Free-text search across the award, e.g. cybersecurity, cloud migration.", "default": [], "items": { "type": "string" } }, "recipientSearch": { "title": "Recipient name contains", "type": "string", "description": "Restrict to one contractor, e.g. Booz Allen. Useful for watching a competitor's book of business.", "default": "" }, "expiringOnly": { "title": "Only return expiring awards", "type": "boolean", "description": "Drop award rows that are not inside the recompete window. Agency summaries are still computed across everything.", "default": false }, "recompeteWindowDays": { "title": "Recompete window (days)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "An award counts as expiring if its period of performance ends within this many days. USAspending cannot filter on this, so it is computed from the returned dates.", "default": 180 }, "naicsCodes": { "title": "NAICS codes", "type": "array", "description": "Industry codes, e.g. 541512 for computer systems design. Contracts and IDVs only.", "default": [], "items": { "type": "string" } }, "pscCodes": { "title": "PSC codes", "type": "array", "description": "Product and service codes, e.g. D307. Contracts and IDVs only.", "default": [], "items": { "type": "string" } }, "setAsideTypes": { "title": "Set-aside types", "type": "array", "description": "e.g. SBA for small business, 8AN for 8(a), SDVOSBC for service-disabled veteran-owned. Leave empty for all.", "default": [], "items": { "type": "string" } }, "placeOfPerformanceStates": { "title": "Place of performance states", "type": "array", "description": "Two-letter US state codes, e.g. VA, MD. Leave empty for all.", "default": [], "items": { "type": "string" } }, "minAwardAmount": { "title": "Minimum award amount (USD)", "minimum": 0, "type": "integer", "description": "Filter out small awards. 0 means no minimum.", "default": 0 }, "maxAwardAmount": { "title": "Maximum award amount (USD)", "minimum": 0, "type": "integer", "description": "0 means no maximum.", "default": 0 }, "fromDate": { "title": "Action date from", "type": "string", "description": "ISO date. Filters on award action date, the only date USAspending will filter on. Defaults to two years ago.", "default": "" }, "toDate": { "title": "Action date to", "type": "string", "description": "ISO date. Defaults to today.", "default": "" }, "includeAwards": { "title": "Include award rows", "type": "boolean", "description": "Return one row per award.", "default": true }, "includeRecompetes": { "title": "Include recompete rows", "type": "boolean", "description": "Return the expiring awards again as their own row type, sorted biggest money first.", "default": true }, "includeAgencySummary": { "title": "Include agency summaries", "type": "boolean", "description": "Per-agency spend, vendor concentration and expiring value.", "default": true }, "maxAwardsPerType": { "title": "Max awards per type", "minimum": 1, "maximum": 10000, "type": "integer", "description": "USAspending serves 100 per page. Awards come back largest first.", "default": 200 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. USAspending is a public API and does not require a proxy.", "default": { "useApifyProxy": 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 } } }, "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 } } } } } } } } } }