SAM Vendor Pursuit Intelligence

Normalize bounded, public SAM.gov opportunity records for vendor pursuit research, with agency, NAICS, deadline, set-aside, place of performance, source evidence, and warning fields.

Store Quickstart

Run this input to exercise the documented first-run path. Review the pricing section before increasing the scope.

{
  "dryRun": false
}

What it returns

• Normalized SAM.gov opportunity rows with source URLs, agency/office, NAICS, set-aside, response deadline, place of performance, pursuit signals, confidence, and relevance score.
• contactHints remains in the output contract for compatibility but is always an empty array. This actor does not harvest contact details.
• Run-level warnings when SAM authentication is unavailable, filters return no rows, or a date cannot be sent to SAM.gov.
• Deterministic dry-run rows for smoke tests and Apify UI previews.
• A local output/result.json file for reproducible smoke tests.

Input

Use input.json as the dry-run quickstart. For a bounded live proof, use keywords=["software"], limit=1, delivery="dataset", dryRun=false, and provide a valid SAM_API_KEY through the runtime or samApiKey input.

• keywords: optional opportunity title/search terms.
• naicsCodes: optional NAICS filters sent as SAM ncode.
• agency: optional client-side agency/office filter.
• postedFrom and postedTo: optional MM/DD/YYYY or YYYY-MM-DD date filters.
• samApiKey: optional input override. Falls back to SAM_API_KEY.
• emitSampleOnAuthMissing: retained for schema compatibility. In a live run, missing authentication always produces zero rows; fabricated sample rows are dry-run only.
• limit: bounded result limit, maximum 100.
• delivery: dataset or webhook.
• webhookUrl: required only when delivery=webhook and dryRun=false.
• dryRun: skips SAM.gov requests and delivery, then writes deterministic sample output.

If the official API returns no rows, the actor writes zero rows and charges zero. It never fabricates a billable opportunity. A live dataset delivery uses only validated public SAM opportunity rows.

Pricing

This actor is intended for PAY_PER_EVENT with a low actor-start fee and the configured apify-default-dataset-item fee of $0.008 per validated public result row. A row is delivered through the Apify SDK default-dataset path and is considered successful only when Apify reports chargedCount >= 1.

Compliance and source boundaries

The actor uses the public SAM.gov opportunities API directly. It does not use search engines, login-only portals, private notices, or contact harvesting. Missing authentication, a source timeout, a zero-result response, or a billing mismatch is reported explicitly; zero-result runs are free and billing mismatches fail closed.