Lead Generation

US Federal Contracting Opportunities

US federal contracting opportunities by NAICS trade, with the named contracting officer on each.

us-federal-contractslead-generationgovernmentprocurementrfpusapublic-record

0 rows in the dataset

Download the dataset

Get every row this scraper has collected as one CSV or JSONL file. If the data is older than maxAgeHours, the scraper is re-run with its configured settings first. The key needs the datasets:export scope.

DOWNLOAD_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/datasets/us-federal-contracts/downloads" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{"maxAgeHours":24,"format":"csv"}' | jq -r '.id')while true; do  STATUS=$(curl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY" | jq -r '.status')  [ "$STATUS" != "refreshing" ] && break  sleep 5donecurl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID/file" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -o dataset.csv

The rate is 1 credit per 100 rows cached and 2 credits live, charged on the rows in the dataset when the download becomes ready. A failed refresh is not charged. The file stays downloadable for 24 hours. See pricing.

Start a run

To choose the targets yourself, send the parameters below as input. The call returns 202 with the run; the key needs the scrapers:run scope and the account a positive credit balance.

curl -X POST "https://api.pandorlabs.com/v1/scrapers/us-federal-contracts/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "naicsCodes": [        "541511",        "541512",        "541519"      ],      "noticeTypes": [        "o",        "p",        "k"      ],      "postedWithinDays": 30,      "states": [        "CA",        "TX",        "NY"      ]    }  }'

A run is billed at the live rate once it finishes: 2 credits per 100 rows it collected. A run that collects nothing costs nothing.

Parameters

Every parameter is optional. Anything you leave out uses the default shown here; an unknown name or an invalid value is rejected with a 400 that lists each problem.

Targeting

naicsCodes
string[]
NAICS codes
One query per code. Software and web work: 541511 (Custom Computer Programming Services), 541512 (Computer Systems Design Services), 541513 (Computer Facilities Management Services), 541519 (Other Computer Related Services), 541430 (Graphic Design Services), 541810 (Advertising Agencies), 511210 (Software Publishers), 518210 (Data Processing, Hosting & Related Services).
Default
["541511","541512","541519"]
Example
541511
noticeTypes
enum[]
Notice types
The defaults are the notices that represent a live buy. Award notices are history, not leads.
Default
["o","p","k"]
Allowed values
o
p
k
r
g
s
i
a
u
postedWithinDays
number
Posted within (days)
Ignored if an explicit posted-from date is set. Ranges over a year are split automatically.
Default
30
Range
1 to 1825
states
string[]
Place of performance states
Two-letter codes. Empty means anywhere.
Default
none
Example
CA, TX, NY
titleContains
string
Title contains
Applied by SAM.gov's own search, not locally.
Default
none
Example
website

Advanced

postedFrom
string
Posted from (MM/DD/YYYY)
Overrides the lookback window.
Default
none
Example
01/01/2026
postedTo
string
Posted to (MM/DD/YYYY)
Default
none
Example
12/31/2026
activeOnly
boolean
Open opportunities only
Drops notices whose response deadline has passed.
Default
true
requireContactEmail
boolean
Require a contact email
Drops notices with no published point of contact.
Default
false
setAsideCodes
string[]
Set-aside codes
Default
none
Example
SBA, 8A, WOSB, SDVOSBC
maxRecords
number
Max records per run
Rows persist and re-runs upsert, so a ceiling here bounds one run, not the dataset.
Default
5000
Range
1 to 100000
pageSize
number
Page size
Default
200
Range
1 to 1000
requestDelayMs
number
Delay between requests (ms)
Default
500
Range
0 to 30000
apiKey
string
API key override
Defaults to the SAM_GOV_API_KEY environment variable. Set here only to run against a different key.
Default
none

Input as JSON Schema

The same schema the API validates against. Use it as a tool input schema or to generate a typed client.

inputSchema

{  "type": "object",  "additionalProperties": false,  "properties": {    "naicsCodes": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "NAICS codes",      "description": "One query per code. Software and web work: 541511 (Custom Computer Programming Services), 541512 (Computer Systems Design Services), 541513 (Computer Facilities Management Services), 541519 (Other Computer Related Services), 541430 (Graphic Design Services), 541810 (Advertising Agencies), 511210 (Software Publishers), 518210 (Data Processing, Hosting & Related Services).",      "default": [        "541511",        "541512",        "541519"      ],      "examples": [        "541511"      ]    },    "noticeTypes": {      "type": "array",      "items": {        "type": "string",        "enum": [          "o",          "p",          "k",          "r",          "g",          "s",          "i",          "a",          "u"        ]      },      "uniqueItems": true,      "title": "Notice types",      "description": "The defaults are the notices that represent a live buy. Award notices are history, not leads.",      "default": [        "o",        "p",        "k"      ]    },    "postedWithinDays": {      "type": "number",      "minimum": 1,      "maximum": 1825,      "title": "Posted within (days)",      "description": "Ignored if an explicit posted-from date is set. Ranges over a year are split automatically.",      "default": 30    },    "states": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Place of performance states",      "description": "Two-letter codes. Empty means anywhere.",      "default": [],      "examples": [        "CA, TX, NY"      ]    },    "titleContains": {      "type": "string",      "maxLength": 2000,      "title": "Title contains",      "description": "Applied by SAM.gov's own search, not locally.",      "examples": [        "website"      ]    },    "postedFrom": {      "type": "string",      "maxLength": 2000,      "title": "Posted from (MM/DD/YYYY)",      "description": "Overrides the lookback window.",      "examples": [        "01/01/2026"      ]    },    "postedTo": {      "type": "string",      "maxLength": 2000,      "title": "Posted to (MM/DD/YYYY)",      "examples": [        "12/31/2026"      ]    },    "activeOnly": {      "type": "boolean",      "title": "Open opportunities only",      "description": "Drops notices whose response deadline has passed.",      "default": true    },    "requireContactEmail": {      "type": "boolean",      "title": "Require a contact email",      "description": "Drops notices with no published point of contact.",      "default": false    },    "setAsideCodes": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Set-aside codes",      "default": [],      "examples": [        "SBA, 8A, WOSB, SDVOSBC"      ]    },    "maxRecords": {      "type": "number",      "minimum": 1,      "maximum": 100000,      "title": "Max records per run",      "description": "Rows persist and re-runs upsert, so a ceiling here bounds one run, not the dataset.",      "default": 5000    },    "pageSize": {      "type": "number",      "minimum": 1,      "maximum": 1000,      "title": "Page size",      "default": 200    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 30000,      "title": "Delay between requests (ms)",      "default": 500    },    "apiKey": {      "type": "string",      "maxLength": 2000,      "title": "API key override",      "description": "Defaults to the SAM_GOV_API_KEY environment variable. Set here only to run against a different key."    }  }}

Run, poll, read rows

The run is asynchronous. Poll it until it reaches a terminal status and its billing is paid, then page through its rows. Until then the rows endpoint answers 409 (still queued or running) or 402 (payment required).

RUN_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/scrapers/us-federal-contracts/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "naicsCodes": [        "541511",        "541512",        "541519"      ],      "noticeTypes": [        "o",        "p",        "k"      ],      "postedWithinDays": 30,      "states": [        "CA",        "TX",        "NY"      ]    }  }' | jq -r '.id')while true; do  RUN=$(curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY")  STATUS=$(echo "$RUN" | jq -r '.status')  BILLING=$(echo "$RUN" | jq -r '.billing.status')  case "$STATUS" in queued|running) ;; *) [ "$BILLING" != "pending" ] && break ;; esac  sleep 5doneecho "$RUN" | jq '{status, rowCount, billing}'curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID/rows?page=1&limit=100" \  -H "Authorization: Bearer $PANDORLABS_KEY"

See the API reference for pagination, cancelling and listing runs.

Output fields

Rows have no fixed schema; these are the fields observed in the rows collected so far. Coverage is the share of rows where the field is present.

No rows collected yet, so no fields have been observed. Run the scraper once and they will appear here.