{ "openapi": "3.0.1", "info": { "title": "USAspending Federal Award Search", "description": "Searches US federal contract, grant and loan awards on USAspending.gov. Its paging flag turns false at 10,000 records while tens of thousands more are still there, so this Actor stops on a short page instead and uses the cursor to read past 50,000. No key and no login.", "version": "0.1", "x-build-id": "vhMYEWf27RGKid3JV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gubidonius~usaspending/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gubidonius-usaspending", "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/gubidonius~usaspending/runs": { "post": { "operationId": "runs-sync-gubidonius-usaspending", "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/gubidonius~usaspending/run-sync": { "post": { "operationId": "run-sync-gubidonius-usaspending", "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", "required": [ "startDate", "endDate" ], "properties": { "startDate": { "title": "Start date", "type": "string", "description": "Beginning of the award action period, as YYYY-MM-DD. Required." }, "endDate": { "title": "End date", "type": "string", "description": "End of the award action period, as YYYY-MM-DD. Required." }, "awardTypes": { "title": "Award types", "type": "array", "description": "Which families of award to include. USAspending will not accept more than one family in a single request, so picking two runs two searches and shares the row limit between them. The families also fill different fields: Contract Award Type is empty on grants and loans, and industry codes are empty on everything except contracts and IDVs.", "items": { "type": "string", "enum": [ "contracts", "grants", "directPayments", "loans", "idvs" ] }, "default": [ "contracts" ] }, "agencyName": { "title": "Awarding agency", "type": "string", "description": "Full name of the top-tier awarding agency, for example National Science Foundation. Leave empty for all agencies." }, "recipientSearch": { "title": "Recipient name contains", "type": "string", "description": "Free text matched against recipient names." }, "keywords": { "title": "Keywords", "type": "array", "description": "Free text matched across the award, including the description.", "items": { "type": "string" } }, "placeOfPerformanceStates": { "title": "Place of performance states", "type": "array", "description": "Two-letter US state codes where the work is performed, for example CA. This is where the work happens, which is often not where the recipient is registered.", "items": { "type": "string" } }, "naics": { "title": "NAICS codes", "type": "array", "description": "Industry codes to filter on.", "items": { "type": "string" } }, "psc": { "title": "PSC codes", "type": "array", "description": "Product and service codes to filter on.", "items": { "type": "string" } }, "maxResults": { "title": "Maximum awards", "minimum": 1, "type": "integer", "description": "Stop after this many. Getting exactly this many is reported as maxResults and never as complete, because the run never saw the end of the results.", "default": 1000 }, "maxRequests": { "title": "Maximum requests", "minimum": 1, "type": "integer", "description": "Ceiling on requests to USAspending. Each request returns 100 awards, so 200 requests reaches 20,000.", "default": 200 } } }, "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 } } } } } } } } } }