{
  "openapi": "3.0.1",
  "info": {
    "title": "Federal Contract Winner Lead Scorer: New GovCon Winners",
    "description": "Companies that just won US federal contracts (USAspending.gov), one row per company scored 0 to 100 as a lead: award value, revenue growth, first win, small business and veteran flags, SAM.gov link. Filter by NAICS, agency, state; skip your CRM. $0.015 per company. Agent-ready: x402, MCP.",
    "version": "0.1",
    "x-build-id": "N9OU6rUaFdIzfnmtL"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/nerolabs~federal-contract-winner-leads/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-nerolabs-federal-contract-winner-leads",
        "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/nerolabs~federal-contract-winner-leads/runs": {
      "post": {
        "operationId": "runs-sync-nerolabs-federal-contract-winner-leads",
        "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/nerolabs~federal-contract-winner-leads/run-sync": {
      "post": {
        "operationId": "run-sync-nerolabs-federal-contract-winner-leads",
        "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": {
          "naicsCodes": {
            "title": "NAICS codes the winners work in",
            "type": "array",
            "description": "NAICS industry codes of the contracts, e.g. 541511 (custom software), 541512 (IT systems design), 236220 (commercial building), 561720 (janitorial), 541330 (engineering). 2 to 6 digits; a shorter code covers the whole branch.",
            "items": {
              "type": "string"
            }
          },
          "pscCodes": {
            "title": "PSC codes (optional)",
            "type": "array",
            "description": "Product and Service Codes of the contracts, e.g. DA01 (IT application support), R499 (professional support), Z1DA (building maintenance).",
            "items": {
              "type": "string"
            }
          },
          "keywords": {
            "title": "Keywords in the award (optional)",
            "type": "array",
            "description": "Words searched in the award description and recipient, e.g. 'cybersecurity', 'cloud', 'HVAC'.",
            "items": {
              "type": "string"
            }
          },
          "agencies": {
            "title": "Awarding agencies (optional)",
            "type": "array",
            "description": "Exact top-level agency names, e.g. 'Department of Veterans Affairs', 'Department of Defense', 'Department of Homeland Security', 'General Services Administration'.",
            "items": {
              "type": "string"
            }
          },
          "recipientStates": {
            "title": "Winner's state (optional)",
            "type": "array",
            "description": "Only companies based in these US states, 2 letter codes: VA, TX, CA, FL.",
            "items": {
              "type": "string"
            }
          },
          "placeOfPerformanceStates": {
            "title": "Where the work is done (optional)",
            "type": "array",
            "description": "Only contracts performed in these US states, 2 letter codes.",
            "items": {
              "type": "string"
            }
          },
          "awardTypes": {
            "title": "Contract types",
            "type": "array",
            "description": "Which kinds of new contract awards count. Empty means all four.",
            "items": {
              "type": "string",
              "enum": [
                "definitive_contract",
                "delivery_order",
                "purchase_order",
                "bpa_call"
              ],
              "enumTitles": [
                "Definitive contracts",
                "Delivery and task orders",
                "Purchase orders",
                "BPA calls"
              ]
            }
          },
          "setAsideTypes": {
            "title": "Set-aside codes (optional)",
            "type": "array",
            "description": "Only awards under these set-asides, e.g. SBA (small business), 8A, 8AN, SDVOSBC (service-disabled veteran), WOSB (women owned), HZC (HUBZone).",
            "items": {
              "type": "string"
            }
          },
          "smallBusinessOnly": {
            "title": "Small businesses only",
            "type": "boolean",
            "description": "Only winners registered as small businesses.",
            "default": false
          },
          "minAwardAmount": {
            "title": "Minimum award (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Skip awards below this value, e.g. 25000 to drop micro purchases."
          },
          "maxAwardAmount": {
            "title": "Maximum award (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Skip awards above this value."
          },
          "awardedWithinDays": {
            "title": "New awards signed in the last N days",
            "minimum": 1,
            "maximum": 365,
            "type": "integer",
            "description": "How far back to look for newly signed contracts. Use 7 for a weekly scheduled monitor. Defense awards appear about 90 days late on USAspending.",
            "default": 30
          },
          "includeHistory": {
            "title": "Add growth, first-win and business type data",
            "type": "boolean",
            "description": "For each company: contract awards won before this window (since 2008), federal revenue in the last two full fiscal years and the growth, and business types (small business, veteran owned, woman owned, 8(a), HUBZone). Included in the price.",
            "default": true
          },
          "minLeadScore": {
            "title": "Minimum lead score (0 to 100)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Only companies scoring this or more are returned and charged. Recency up to 25, new award value 25, revenue growth 20, newness to federal work 20, small business 10.",
            "default": 0
          },
          "maxLeads": {
            "title": "Maximum companies returned",
            "minimum": 1,
            "maximum": 2000,
            "type": "integer",
            "description": "The best scoring companies up to this number are returned (and charged), highest score first.",
            "default": 100
          },
          "maxAwardsScanned": {
            "title": "Maximum awards scanned",
            "minimum": 100,
            "maximum": 10000,
            "type": "integer",
            "description": "How many new awards to read before grouping and scoring (newest first). Scanning is free; only returned companies are charged.",
            "default": 2000
          },
          "excludeCompanies": {
            "title": "Companies to skip",
            "type": "array",
            "description": "Company names or UEIs you already work with or sell to. Skipped and never charged.",
            "items": {
              "type": "string"
            }
          },
          "excludeCompaniesUrl": {
            "title": "Skip list from your CRM (CSV or Google Sheet link)",
            "type": "string",
            "description": "Link to a CSV or a Google Sheet shared as 'Anyone with the link can view', e.g. a CRM export. UEIs anywhere in it, and names in a column called company, name, account or organization, are skipped and never charged."
          },
          "monitorMode": {
            "title": "Monitor mode: only winners not returned before",
            "type": "boolean",
            "description": "Remembers every award already returned under this watch name and returns only companies with a new award, so a weekly schedule sends just fresh leads. Already-returned awards are never charged again.",
            "default": false
          },
          "watchName": {
            "title": "Watch name (monitor mode)",
            "type": "string",
            "description": "Keep one watch per territory or client, e.g. 'va-it' and 'texas-construction'.",
            "default": "default"
          },
          "webhookUrl": {
            "title": "Webhook URL (optional)",
            "type": "string",
            "description": "POST a JSON summary with the top leads here when the run ends (in monitor mode only when there are new leads). Works with Slack workflows, Zapier, Make and n8n. Free."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}