{ "openapi": "3.0.1", "info": { "title": "Federal Contract Awards Scraper - USAspending Data", "description": "Export US federal contract award data from USAspending.gov with no API key. Full detail by NAICS, PSC, agency, recipient, and place of performance. Contracts + IDVs.", "version": "1.0", "x-build-id": "YcvPMNWsKVAzanboJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maydit~us-federal-contract-awards-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maydit-us-federal-contract-awards-scraper", "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/maydit~us-federal-contract-awards-scraper/runs": { "post": { "operationId": "runs-sync-maydit-us-federal-contract-awards-scraper", "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/maydit~us-federal-contract-awards-scraper/run-sync": { "post": { "operationId": "run-sync-maydit-us-federal-contract-awards-scraper", "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": { "awardTypeGroup": { "title": "Award type", "enum": [ "contracts", "idvs" ], "type": "string", "description": "Which kind of federal awards to pull. Contracts = definitive/purchase-order/BPA-call contracts. IDVs = indefinite delivery vehicles (GWACs, IDIQs, BPAs).", "default": "contracts" }, "actionDateSince": { "title": "Awarded since", "type": "string", "description": "Only awards with an action date on or after this date (YYYY-MM-DD). Great for weekly monitoring of newly-awarded contracts." }, "actionDateUntil": { "title": "Awarded until", "type": "string", "description": "Only awards with an action date on or before this date (YYYY-MM-DD)." }, "awardingAgency": { "title": "Awarding agency (top-tier)", "type": "string", "description": "Exact official top-tier awarding agency name, spelled and capitalized as USAspending publishes it, e.g. 'Department of Defense', 'Department of Veterans Affairs', 'General Services Administration'. Abbreviations and different casing return zero rows. Leave empty for all agencies." }, "recipientSearch": { "title": "Recipient name search", "type": "string", "description": "Partial company-name match against the award recipient, e.g. 'Lockheed Martin' also matches 'LOCKHEED MARTIN CORPORATION'. Case does not matter. Leave empty for all recipients." }, "naicsCodes": { "title": "NAICS codes", "type": "array", "description": "Filter by industry NAICS codes, e.g. '236220' (commercial building construction), '541512' (computer systems design). Leave empty for all.", "default": [], "items": { "type": "string" } }, "placeOfPerformanceStates": { "title": "Place of performance states", "type": "array", "description": "Two-letter US state codes for where the work is performed, e.g. 'CA', 'TX', 'VA'. Leave empty for all.", "default": [], "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Free-text terms matched against award descriptions and related fields, e.g. 'cybersecurity' or 'zero trust'. Multiple entries broaden the search. Leave empty to skip keyword filtering.", "default": [], "items": { "type": "string" } }, "minAmount": { "title": "Minimum award amount (USD)", "type": "integer", "description": "Only return awards whose award amount is at or above this many US dollars. Enter a plain number with no commas or currency symbol, e.g. 1000000 for $1M. Leave empty for no lower bound." }, "maxAmount": { "title": "Maximum award amount (USD)", "type": "integer", "description": "Only return awards whose award amount is at or below this many US dollars. Enter a plain number with no commas or currency symbol, e.g. 50000000 for $50M. Leave empty for no upper bound." }, "sortBy": { "title": "Sort by", "enum": [ "Award Amount", "Start Date" ], "type": "string", "description": "Order results by award amount (largest first) or start date (newest first).", "default": "Award Amount" }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Upper bound on how many awards a single run returns. The actor pages through the source 100 awards at a time and stops once this many rows have been written, so a smaller number means a faster, cheaper run.", "default": 1000 } } }, "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 } } } } } } } } } }