{ "openapi": "3.0.1", "info": { "title": "Federal Contract Award Winners Feed (Unofficial)", "description": "Companies that just won federal contracts, IDVs or grants: winner, UEI, amount, agency, NAICS and location, with per-winner totals and optional prime subcontracts. New-since-last-run mode. From USAspending.gov data; no API key.", "version": "1.0", "x-build-id": "TYd6or0eoCKsLjYMj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/saiberops~federal-award-winners-feed/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-saiberops-federal-award-winners-feed", "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/saiberops~federal-award-winners-feed/runs": { "post": { "operationId": "runs-sync-saiberops-federal-award-winners-feed", "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/saiberops~federal-award-winners-feed/run-sync": { "post": { "operationId": "run-sync-saiberops-federal-award-winners-feed", "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": { "mode": { "title": "What to fetch", "enum": [ "latest", "newSinceLastRun", "dateRange" ], "type": "string", "description": "latest: awards from the last N days. newSinceLastRun: only awards your previous runs didn't return (use it on a schedule). dateRange: a fixed start and end date (up to 366 days per run).", "default": "latest" }, "lookbackDays": { "title": "Days to look back", "minimum": 1, "maximum": 180, "type": "integer", "description": "Calendar days including today. Up to 90 for 'latest', up to 180 for 'newSinceLastRun'. Defense awards appear about 90 days after signing: to get them with 'newSinceLastRun', use 100 or more and narrow filters (NAICS, agency, state).", "default": 7 }, "startDate": { "title": "Start date (date range mode)", "type": "string", "description": "First date to include, YYYY-MM-DD." }, "endDate": { "title": "End date (date range mode)", "type": "string", "description": "Last date to include, YYYY-MM-DD. Defaults to today." }, "dateBasis": { "title": "Which awards count as new", "enum": [ "newAwards", "allActions" ], "type": "string", "description": "newAwards: the base award was signed in the window (new wins only). allActions: any award with an obligation or modification in the window (also catches option exercises and add-on funding).", "default": "newAwards" }, "awardTypes": { "title": "Award types", "type": "array", "description": "Contracts (purchase orders, delivery orders, definitive contracts, BPA calls), IDVs (new IDIQs, GWACs, schedules, BPAs) and grants (block, formula and project grants, cooperative agreements). Grants are searched among organizations only; contract and IDV rows whose recipient name looks like a person's are dropped (not charged).", "items": { "type": "string", "enum": [ "contracts", "idvs", "grants" ], "enumTitles": [ "Contracts", "IDVs (contract vehicles)", "Grants and cooperative agreements" ] }, "default": [ "contracts" ] }, "includeSubawards": { "title": "Add subcontracts reported by primes (paid add-on)", "type": "boolean", "description": "Also returns subcontracts that prime contractors reported in the window (who the primes are hiring). Charged per subaward row (see Pricing).", "default": false }, "naicsCodes": { "title": "NAICS codes", "type": "array", "description": "2- to 6-digit NAICS codes or prefixes, for example 541512 or 23 (construction). Contracts only. Leave empty for all industries.", "items": { "type": "string" } }, "pscCodes": { "title": "Product and service codes (PSC)", "type": "array", "description": "4-character PSC codes such as DA01 (matched by USAspending) or shorter prefixes such as D or R4 (matched by the Actor). Contracts only.", "items": { "type": "string" } }, "agencies": { "title": "Agencies (top tier)", "type": "array", "description": "Exact top-tier agency names as USAspending writes them, for example Department of Defense, Department of Homeland Security. Leave empty for all.", "items": { "type": "string" } }, "subAgencies": { "title": "Sub-agencies", "type": "array", "description": "Exact sub-tier names, for example U.S. Army Corps of Engineers, Federal Emergency Management Agency.", "items": { "type": "string" } }, "agencyRole": { "title": "Agency filter applies to", "enum": [ "awarding", "funding" ], "type": "string", "description": "Match the agency that made the award (usual) or the agency that pays for it.", "default": "awarding" }, "recipientStates": { "title": "Winner's state", "type": "array", "description": "Two-letter codes of the winning company's location, for example GA, FL. Use this for territory-based sales lists.", "items": { "type": "string" } }, "placeOfPerformanceStates": { "title": "Place of performance states", "type": "array", "description": "Two-letter codes where the work is performed.", "items": { "type": "string" } }, "recipientTypes": { "title": "Winner business types", "type": "array", "description": "Keep winners with any of these business types, for example small or women-owned businesses.", "items": { "type": "string", "enum": [ "small_business", "other_than_small_business", "women_owned_small_business", "economically_disadvantaged_women_owned_small_business", "service_disabled_veteran_owned_business", "veteran_owned_business", "8a_program_participant", "historically_underutilized_business_firm", "small_disadvantaged_business", "minority_owned_business", "woman_owned_business", "tribally_owned_firm", "alaskan_native_corporation_owned_firm", "limited_liability_corporation", "corporate_entity_not_tax_exempt", "nonprofit", "higher_education", "government", "foreign_owned" ], "enumTitles": [ "Small business", "Other than small business", "Women-owned small business", "Economically disadvantaged WOSB", "Service-disabled veteran-owned", "Veteran-owned", "8(a) participant", "HUBZone firm", "Small disadvantaged business", "Minority-owned", "Woman-owned", "Tribally owned", "Alaskan Native Corporation owned", "LLC", "Corporation (not tax exempt)", "Nonprofit", "Higher education", "Government", "Foreign-owned" ] }, "default": [] }, "setAsideTypes": { "title": "Set-aside types", "type": "array", "description": "Keep contracts awarded under these set-asides (contracts only). Leave empty for all.", "items": { "type": "string", "enum": [ "NONE", "SBA", "SBP", "8A", "8AN", "HZC", "HZS", "SDVOSBC", "SDVOSBS", "WOSB", "WOSBSS", "EDWOSB", "EDWOSBSS", "VSA", "VSS", "ISBEE" ], "enumTitles": [ "No set-aside", "Small business (total)", "Small business (partial)", "8(a) competed", "8(a) sole source", "HUBZone set-aside", "HUBZone sole source", "SDVOSB set-aside", "SDVOSB sole source", "WOSB set-aside", "WOSB sole source", "EDWOSB set-aside", "EDWOSB sole source", "Veteran set-aside", "Veteran sole source", "Indian small business economic enterprise" ] }, "default": [] }, "minAmount": { "title": "Minimum award amount (USD)", "minimum": 0, "type": "integer", "description": "Skip awards below this amount. Leave empty for no minimum." }, "maxAmount": { "title": "Maximum award amount (USD)", "minimum": 0, "type": "integer", "description": "Skip awards above this amount. Leave empty for no maximum." }, "keywords": { "title": "Keywords", "type": "array", "description": "Words searched by USAspending across award descriptions and other award text, including recipient names, for example drone, janitorial. At least 3 characters each.", "items": { "type": "string" } }, "includeContractDetails": { "title": "Add set-aside, competition and business types", "type": "boolean", "description": "Looks up each contract's set-aside, extent competed, number of offers, parent vehicle, office, parent company and the winner's business types (one extra request per row, no extra charge; slower).", "default": false }, "maxItems": { "title": "Max awards", "minimum": 1, "maximum": 10000, "type": "integer", "description": "The run stops after this many award rows. Each returned award is one charged event.", "default": 500 }, "maxSubawards": { "title": "Max subawards", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Upper limit on subaward rows when the subaward add-on is on.", "default": 200 }, "cursorName": { "title": "Cursor name (new since last run)", "type": "string", "description": "Keeps a separate 'new since last run' position per name, so different scheduled feeds (for example GA construction vs. VA IT) don't share one. Letters, numbers and dashes.", "default": "" }, "maxPagesToScan": { "title": "Max pages to scan", "minimum": 1, "maximum": 100, "type": "integer", "description": "Upper limit on 100-row result pages read per award type per run.", "default": 50 } } }, "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 } } } } } } } } } }