{ "openapi": "3.0.1", "info": { "title": "USAspending Federal Awards Scraper", "description": "USAspending scraper & API: search US federal contracts, grants and awards and export recipient, agency, amount, award type, dates, place of performance and NAICS. Government-contract intelligence and B2B lead generation — fast, no login.", "version": "0.0", "x-build-id": "zeyTaTgqfwrwcUaQJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/haketa~usaspending-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-haketa-usaspending-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/haketa~usaspending-scraper/runs": { "post": { "operationId": "runs-sync-haketa-usaspending-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/haketa~usaspending-scraper/run-sync": { "post": { "operationId": "run-sync-haketa-usaspending-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": { "awardTypeCategories": { "title": "Award types", "type": "array", "description": "Which categories of federal spending to pull. Pick one or more. Leave as-is to focus on contracts.", "items": { "type": "string", "enum": [ "contracts", "idvs", "grants", "loans", "other_financial_assistance", "direct_payments" ], "enumTitles": [ "Contracts", "IDVs (Indefinite Delivery)", "Grants", "Loans", "Other Financial Assistance", "Direct Payments" ] }, "default": [ "contracts" ] }, "keywords": { "title": "Keywords (optional)", "type": "array", "description": "Optional free-text search across award descriptions. Great for finding specific topics such as cybersecurity, cloud migration, AI, or logistics. Leave empty to browse everything.", "default": [], "items": { "type": "string" } }, "recipientSearchText": { "title": "Recipient name (optional)", "type": "string", "description": "Optional. Type part of a contractor / company name to find every award they won (for example Lockheed, Booz Allen, or Microsoft).", "default": "" }, "agencyNames": { "title": "Awarding agencies", "type": "array", "description": "Pick one or more federal agencies to focus on. Leave empty to include every agency.", "items": { "type": "string", "enum": [ "Department of Defense", "Department of Health and Human Services", "Department of Veterans Affairs", "Department of Homeland Security", "Department of Energy", "Department of the Treasury", "Department of Agriculture", "Department of Justice", "Department of State", "Department of Transportation", "Department of the Interior", "Department of Commerce", "Department of Labor", "Department of Education", "Department of Housing and Urban Development", "General Services Administration", "National Aeronautics and Space Administration", "Small Business Administration", "Social Security Administration", "Environmental Protection Agency", "National Science Foundation", "Agency for International Development", "Nuclear Regulatory Commission", "Office of Personnel Management", "Securities and Exchange Commission", "Federal Communications Commission", "Corps of Engineers - Civil Works", "Executive Office of the President", "National Archives and Records Administration", "Millennium Challenge Corporation" ], "enumTitles": [ "Department of Defense", "Health & Human Services (HHS)", "Veterans Affairs (VA)", "Homeland Security (DHS)", "Department of Energy (DOE)", "Department of the Treasury", "Department of Agriculture (USDA)", "Department of Justice (DOJ)", "Department of State", "Department of Transportation (DOT)", "Department of the Interior (DOI)", "Department of Commerce", "Department of Labor (DOL)", "Department of Education", "Housing & Urban Development (HUD)", "General Services Administration (GSA)", "NASA", "Small Business Administration (SBA)", "Social Security Administration (SSA)", "Environmental Protection Agency (EPA)", "National Science Foundation (NSF)", "USAID", "Nuclear Regulatory Commission (NRC)", "Office of Personnel Management (OPM)", "Securities & Exchange Commission (SEC)", "Federal Communications Commission (FCC)", "US Army Corps of Engineers (Civil Works)", "Executive Office of the President", "National Archives (NARA)", "Millennium Challenge Corporation" ] }, "default": [] }, "naicsCodes": { "title": "Industry (NAICS)", "type": "array", "description": "Pick one or more industries to focus on. Leave empty to include every industry.", "items": { "type": "string", "enum": [ "541512", "541511", "541519", "541330", "541611", "541990", "541715", "236220", "237310", "237990", "336411", "336413", "336611", "561210", "561612", "561720", "621111", "621511", "622110", "325412", "334511", "334220", "517311", "518210", "519130", "611310", "611430", "484121", "488510", "221310", "237110" ], "enumTitles": [ "541512 — Computer Systems Design", "541511 — Custom Computer Programming", "541519 — Other Computer Related Services", "541330 — Engineering Services", "541611 — Administrative Management Consulting", "541990 — Professional/Scientific/Technical Services", "541715 — R&D in Physical/Engineering/Life Sciences", "236220 — Commercial Building Construction", "237310 — Highway, Street & Bridge Construction", "237990 — Other Heavy Construction", "336411 — Aircraft Manufacturing", "336413 — Aircraft Parts Manufacturing", "336611 — Ship Building & Repairing", "561210 — Facilities Support Services", "561612 — Security Guard & Patrol Services", "561720 — Janitorial Services", "621111 — Offices of Physicians", "621511 — Medical Laboratories", "622110 — General Medical & Surgical Hospitals", "325412 — Pharmaceutical Preparation Mfg", "334511 — Search, Detection & Navigation Instruments", "334220 — Radio/TV & Wireless Comms Equipment", "517311 — Wired Telecommunications Carriers", "518210 — Data Processing & Hosting", "519130 — Internet Publishing & Web Portals", "611310 — Colleges & Universities", "611430 — Professional & Management Training", "484121 — General Freight Trucking (Long-distance)", "488510 — Freight Transportation Arrangement", "221310 — Water Supply & Irrigation", "237110 — Water & Sewer Line Construction" ] }, "default": [] }, "naicsCodesCustom": { "title": "Custom NAICS codes (advanced, optional)", "type": "array", "description": "Advanced: add any other NAICS industry codes not in the list above (2 / 4 / 6 digit). Combined with the picks above.", "default": [], "items": { "type": "string" } }, "setAsideTypes": { "title": "Small-business set-asides", "type": "array", "description": "Focus on awards reserved for specific small-business programs. Leave empty to include all awards.", "items": { "type": "string", "enum": [ "SBA", "SBP", "8A", "8AN", "WOSB", "WOSBSS", "EDWOSB", "EDWOSBSS", "HUBZ", "HZC", "HZS", "SDVOSBC", "SDVOSBS", "VSA", "VSS", "IEE", "ISBEE", "BICiv", "RSB" ], "enumTitles": [ "Small Business Set-Aside (Total)", "Small Business Set-Aside (Partial)", "8(a) Program", "8(a) Sole Source", "Women-Owned Small Business (WOSB)", "WOSB Sole Source", "Economically Disadvantaged WOSB (EDWOSB)", "EDWOSB Sole Source", "HUBZone Set-Aside", "HUBZone Sole Source", "HUBZone Price Evaluation", "Service-Disabled Veteran-Owned (SDVOSB)", "SDVOSB Sole Source", "Veteran-Owned Small Business (Set-Aside)", "Veteran-Owned Small Business (Sole Source)", "Indian Economic Enterprise", "Indian Small Business Economic Enterprise", "Buy Indian", "Reserved for Small Business" ] }, "default": [] }, "recipientLocationStates": { "title": "Contractor location (US states)", "type": "array", "description": "Only include contractors headquartered in these states. Leave empty for nationwide.", "items": { "type": "string", "enum": [ "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "PR", "GU", "VI", "AS", "MP" ], "enumTitles": [ "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado", "Connecticut", "Delaware", "District of Columbia", "Florida", "Georgia", "Hawaii", "Idaho", "Illinois", "Indiana", "Iowa", "Kansas", "Kentucky", "Louisiana", "Maine", "Maryland", "Massachusetts", "Michigan", "Minnesota", "Mississippi", "Missouri", "Montana", "Nebraska", "Nevada", "New Hampshire", "New Jersey", "New Mexico", "New York", "North Carolina", "North Dakota", "Ohio", "Oklahoma", "Oregon", "Pennsylvania", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont", "Virginia", "Washington", "West Virginia", "Wisconsin", "Wyoming", "Puerto Rico", "Guam", "US Virgin Islands", "American Samoa", "Northern Mariana Islands" ] }, "default": [] }, "placeOfPerformanceStates": { "title": "Place of performance (US states)", "type": "array", "description": "Only include awards performed in these states. Leave empty for nationwide.", "items": { "type": "string", "enum": [ "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "PR", "GU", "VI", "AS", "MP" ], "enumTitles": [ "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado", "Connecticut", "Delaware", "District of Columbia", "Florida", "Georgia", "Hawaii", "Idaho", "Illinois", "Indiana", "Iowa", "Kansas", "Kentucky", "Louisiana", "Maine", "Maryland", "Massachusetts", "Michigan", "Minnesota", "Mississippi", "Missouri", "Montana", "Nebraska", "Nevada", "New Hampshire", "New Jersey", "New Mexico", "New York", "North Carolina", "North Dakota", "Ohio", "Oklahoma", "Oregon", "Pennsylvania", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont", "Virginia", "Washington", "West Virginia", "Wisconsin", "Wyoming", "Puerto Rico", "Guam", "US Virgin Islands", "American Samoa", "Northern Mariana Islands" ] }, "default": [] }, "timePeriodStart": { "title": "From date (optional)", "type": "string", "description": "Only include awards active on/after this date. Leave empty to use the last full fiscal year.", "default": "" }, "timePeriodEnd": { "title": "To date (optional)", "type": "string", "description": "Only include awards active on/before this date. Leave empty for today.", "default": "" }, "minAwardAmount": { "title": "Minimum award amount (USD)", "minimum": 0, "type": "integer", "description": "Only include awards worth at least this much. 0 = no minimum.", "default": 0 }, "maxAwardAmount": { "title": "Maximum award amount (USD)", "minimum": 0, "type": "integer", "description": "Only include awards worth at most this much. 0 = no maximum.", "default": 0 }, "sortBy": { "title": "Sort by", "enum": [ "Award Amount", "Start Date", "End Date", "Recipient Name", "Award ID" ], "type": "string", "description": "How to order the results.", "default": "Award Amount" }, "sortOrder": { "title": "Sort order", "enum": [ "desc", "asc" ], "type": "string", "description": "Show largest/latest first, or smallest/oldest first.", "default": "desc" }, "scrapeAwardDetails": { "title": "Include full award details", "type": "boolean", "description": "Pull the full record for each award — recipient UEI, full address, NAICS hierarchy, set-aside type, executive compensation, place of performance and more. Turn OFF for ultra-fast bulk discovery.", "default": true }, "maxRecords": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Maximum number of awards to return. 0 = unlimited (millions of awards exist, so a limit is recommended).", "default": 100 }, "requestDelay": { "title": "Request delay (ms)", "minimum": 0, "type": "integer", "description": "Politeness delay between requests.", "default": 250 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many award records to fetch in parallel.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Runs fine without a proxy — only enable one if you are running very large volumes." } } }, "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 } } } } } } } } } }