{ "openapi": "3.0.1", "info": { "title": "USAspending Scraper: New Federal Contract & Grant Awards", "description": "Pull new US federal contract, IDV, grant and loan awards from the official USAspending.gov API (no key). Filter by NAICS, PSC, agency, state, keyword, recipient and amount. Flat JSON for lead gen, competitor tracking and AI agents. 'Only new' mode for award alerts.", "version": "0.1", "x-build-id": "o8aWS7xJz2rUWQqci" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/radiant_opuntia~usaspending-awards-alerts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-radiant_opuntia-usaspending-awards-alerts", "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/radiant_opuntia~usaspending-awards-alerts/runs": { "post": { "operationId": "runs-sync-radiant_opuntia-usaspending-awards-alerts", "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/radiant_opuntia~usaspending-awards-alerts/run-sync": { "post": { "operationId": "run-sync-radiant_opuntia-usaspending-awards-alerts", "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": { "awardCategories": { "title": "Award categories", "type": "array", "description": "Each category is queried separately.", "items": { "type": "string", "enum": [ "contracts", "idvs", "grants", "loans" ], "enumTitles": [ "Contracts", "IDVs (GWACs, BPAs, IDIQs)", "Grants & cooperative agreements", "Loans" ] }, "default": [ "contracts" ] }, "keywords": { "title": "Keywords", "type": "array", "description": "Matched against award descriptions and other text (3+ characters each).", "default": [], "items": { "type": "string" } }, "naicsCodes": { "title": "NAICS codes", "type": "array", "description": "e.g. 541512 (computer systems design), 236220 (commercial construction). 2-6 digits.", "default": [], "items": { "type": "string" } }, "pscCodes": { "title": "PSC codes", "type": "array", "description": "Product/Service Codes, e.g. DA01, R425.", "default": [], "items": { "type": "string" } }, "awardingAgencies": { "title": "Awarding agencies (top-tier names)", "type": "array", "description": "Exact names, e.g. 'Department of Defense', 'Department of Veterans Affairs', 'Department of Health and Human Services'.", "default": [], "items": { "type": "string" } }, "performanceStates": { "title": "Place-of-performance states", "type": "array", "description": "Two-letter state codes, e.g. VA, MD, TX.", "default": [], "items": { "type": "string" } }, "recipientName": { "title": "Recipient name or UEI", "type": "string", "description": "Track a specific competitor or company." }, "minAmount": { "title": "Minimum award amount (USD)", "minimum": 0, "type": "integer", "description": "0 = no minimum.", "default": 0 }, "maxAmount": { "title": "Maximum award amount (USD)", "minimum": 0, "type": "integer", "description": "0 = no maximum.", "default": 0 }, "dateType": { "title": "Date filter applies to", "enum": [ "new_awards_only", "action_date", "last_modified_date", "date_signed" ], "type": "string", "description": "'New awards only' = awards whose base transaction falls in the window.", "default": "new_awards_only" }, "daysBack": { "title": "Last N days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Used when no start date is given. Agencies report with a lag, so 14-30 days is typical for alerts.", "default": 30 }, "startDate": { "title": "Start date (YYYY-MM-DD)", "type": "string", "description": "Optional. Earliest supported is 2007-10-01." }, "endDate": { "title": "End date (YYYY-MM-DD)", "type": "string", "description": "Optional. Defaults to today." }, "onlyNew": { "title": "Only new since last run (alerts mode)", "type": "boolean", "description": "Skip awards (and unchanged award versions) returned by earlier runs of this same search.", "default": false }, "stateKey": { "title": "Alert name (optional)", "type": "string", "description": "Separate memory for 'only new' mode. Defaults to a key derived from your filters." }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many awards.", "default": 500 } } }, "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 } } } } } } } } } }