{ "openapi": "3.0.1", "info": { "title": "Federal Contract Awards - USAspending, Expiring Contracts", "description": "Search U.S. federal contract awards on USAspending.gov by keyword, NAICS code, contractor or agency. Get the contractor, address, amount, agency, NAICS, PSC, dates and days until the contract ends, and find contracts ending soon. No API key needed; optional SAM.gov enrichment.", "version": "1.0", "x-build-id": "1gduJforYBUvNfEbh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/optimistical_lectern~federal-contract-vendor-enricher/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-optimistical_lectern-federal-contract-vendor-enricher", "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/optimistical_lectern~federal-contract-vendor-enricher/runs": { "post": { "operationId": "runs-sync-optimistical_lectern-federal-contract-vendor-enricher", "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/optimistical_lectern~federal-contract-vendor-enricher/run-sync": { "post": { "operationId": "run-sync-optimistical_lectern-federal-contract-vendor-enricher", "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": { "keywords": { "title": "Keywords", "type": "array", "description": "Words in the award description, e.g. 'zero trust', 'cybersecurity', 'help desk'. At least 3 characters each.", "items": { "type": "string" } }, "naicsCodes": { "title": "NAICS codes", "type": "array", "description": "2 to 6 digits, e.g. 541512 (computer systems design) or 5415 (all computer services).", "items": { "type": "string" } }, "vendorNames": { "title": "Contractor names", "type": "array", "description": "Only awards to these contractors, e.g. 'Leidos', 'Booz Allen'.", "items": { "type": "string" } }, "awardingAgencies": { "title": "Awarding agencies", "type": "array", "description": "Top-level agency names as USAspending writes them, e.g. 'Department of Defense', 'Department of Homeland Security'.", "items": { "type": "string" } }, "minAwardAmount": { "title": "Minimum award amount (USD)", "minimum": 0, "type": "integer", "description": "Skip smaller awards. Leave empty for no minimum." }, "contractStatus": { "title": "Contracts to include", "enum": [ "any", "active", "ending" ], "type": "string", "description": "\"Ending soon\" returns running contracts that end within the number of days below, soonest first: the ones likely to be recompeted.", "default": "any" }, "endingWithinDays": { "title": "Ending within (days)", "minimum": 1, "type": "integer", "description": "Used with \"Only contracts ending soon\".", "default": 180 }, "startDate": { "title": "Activity from", "type": "string", "description": "Awards with an action (new award or modification) on or after this date. Defaults to one year ago. Earliest is 2007-10-01." }, "endDate": { "title": "Activity until", "type": "string", "description": "Defaults to today." }, "maxResults": { "title": "Maximum contracts", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after saving this many.", "default": 100 }, "samGovApiKey": { "title": "SAM.gov API key (optional)", "type": "string", "description": "Your free SAM.gov public API key. Adds CAGE code, website, registration status and business types for each contractor. Personal keys allow a limited number of lookups a day; once used up, results continue without SAM.gov data." } } }, "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 } } } } } } } } } }