SAM.gov API & Scraper: Contract Opportunities and Awards

This SAM.gov API alternative exports federal contract opportunities and award notices into a structured dataset, without a SAM.gov API key. Find solicitations by NAICS, PSC, set-aside or agency, track response deadlines, and connect awarded suppliers to other datasets through their UEI and CAGE identifiers.

Use the actor to monitor solicitations, presolicitations, combined synopsis/solicitations, sources sought, special notices, justifications, consolidated or bundled requirements, and sales of surplus property. Each notice becomes one row, including awards. A solicitation and its later award can be separate notices with their own IDs and parent or related notice references.

What does this SAM.gov API return?

• Opportunity data: notice ID, public SAM.gov URL, title, notice type, solicitation number, publication date, response deadline (with source timezone and in UTC), archive date and active or cancelled status.
• Agency hierarchy: department, sub-tier agency, purchasing office and the full organization path with codes and SAM.gov organization IDs.
• Classification: NAICS codes, PSC code, set-aside code and set-aside name.
• People and places: primary and secondary contacts with name, email and phone, and the place of performance.
• Documents: the full plain-text and HTML description, and attachment metadata with stable download URLs.
• Awards: award amount in USD, award date, award number, awardee name, awardee UEI, CAGE code and supplier location.

Use cases for SAM.gov contract opportunities

Government suppliers build a shortlist of open contract opportunities by industry classification and set-aside eligibility, for example every small-business set-aside under NAICS 541512 with a response deadline in the next two weeks.

Bid and proposal consultants monitor notices for a department or purchasing office, read the full description and attachments, and pass the contact details to their clients.

GovCon sales and business development teams inspect award notices to see which suppliers win which contracts and for how much, then use the awardee UEI to enrich the supplier with spending history and company records.

Market researchers and analysts schedule a daily run, append new notices to a warehouse, and measure demand per agency, NAICS code or set-aside program over time.

Keep notice_id as your notice identity and use awardee_uei when joining suppliers to USAspending or business records. Supplier names alone can vary between sources.

The buyer country is US, because the purchasing organization is a US federal entity. The place of performance is a separate object and can describe a location outside the United States. For example, the genuine award shown below concerns a truck at Aviano in Italy.

Input

The default search returns up to 50 active notices ordered by latest modification, with full details and attachment metadata. All filters are optional. For a broader dataset, increase max_items within the 10,000-notice source window.

keywords accepts search terms or a solicitation number. Set keyword_mode to all, any, or exact; the default is all. Use notice_types to restrict the type of announcement, naics_codes to filter industries, and psc_codes for product or service classifications. Codes are strings. NAICS and PSC prefixes are supported. set_aside_codes accepts SAM.gov codes such as SBA, SDVOSBC, WOSB, 8A, and NONE.

agency accepts a numeric SAM.gov organization ID or an agency name. A name resolves to the highest-scoring organization returned by SAM.gov; the selected name and ID appear in the output. You can supply a department, a sub-tier agency, or an office ID. Use status with active, archived, or all to select the notice lifecycle.

Publication, modification, and response deadlines each have independent date ranges: posted_from and posted_to, modified_from and modified_to, and response_from and response_to. Supply calendar dates as YYYY-MM-DD. Date ranges include their end day and use US Eastern time, including daylight saving time. Returned deadlines preserve the source offset and timezone.

If a search result provides a response date without a time, deadline is null and deadline_utc retains the source value. Midnight UTC in that value does not establish a local closing time. A detail record with a response time supplies the exact deadline when available.

For direct retrieval, provide notice_ids as a list of IDs or public SAM.gov opportunity URLs. This mode takes priority over search filters. The max_items limit also applies here and defaults to 50; increase it to collect a longer list. If the unique ID count exceeds that limit, the output includes a warning and delivery stops at the limit. Unknown IDs are skipped with a warning; an input containing only unknown IDs returns no dataset rows. Direct retrieval requires detail requests, even if include_details is false. Duplicate notice IDs are delivered once. Temporary lookup failures are retried before the remaining IDs are collected.

This real award can be retrieved with:

{"notice_ids":["1ff88d655e55422dbbcd75dd64e21db2"],"include_attachments":false}

include_details: false collects search records with title, notice type, reference number, agency hierarchy, and available search timestamps. The full description remains null; an available search excerpt is stored separately in description_snippet. Attachment metadata requires details. Set include_attachments: false when you do not need file or link references.

Output

Each dataset row includes source, fetched_at, notice_id, url, position, title, notice_type, reference_number, buyer, country, published_at, and deadline. Details add the full plain-text and HTML descriptions, NAICS codes, PSC code, set-aside code and name, contacts, archive information, and place of performance when SAM.gov provides them.

Award records can include award_amount, currency, award_date, award_number, awardee_name, awardee_uei, awardee_cage, and supplier location. Amounts are numbers. Missing source fields are null or empty lists; the actor does not infer an award value or supplier identifier.

The following selected fields come from the genuine SAM.gov award shown above:

{
  "notice_id":"1ff88d655e55422dbbcd75dd64e21db2",
  "title":"31 LRS European 4x2 Tractor Truck",
  "notice_type":"Award Notice",
  "reference_number":"FA568226P0105",
  "sub_tier":"DEPT OF THE AIR FORCE",
  "naics_codes":["336212"],
  "psc_code":"2320",
  "award_amount":146991.35,
  "currency":"USD",
  "award_date":"2026-09-29",
  "awardee_name":"UNITED CAPITAL INVESTMENTS GROUP, INC.",
  "awardee_uei":"QDHNQJ9FHJW1",
  "awardee_cage":"62VC7"
}

And these selected fields come from a genuine open solicitation (9a3bdbabfbe9425fb7ff750f4368004a), with one of its five attachments:

{
  "notice_id":"9a3bdbabfbe9425fb7ff750f4368004a",
  "title":"Ie Shima Barge Transportation",
  "notice_type":"Solicitation",
  "reference_number":"M2900027Q3000",
  "sub_tier":"DEPT OF THE NAVY",
  "deadline":"2026-10-07T10:00:00+09:00",
  "naics_codes":["483113"],
  "psc_code":"V115",
  "set_aside_code":"NONE",
  "set_aside":"No set-aside",
  "attachments":[{
    "type":"file",
    "name":"A01_PWS_KS27 ISTF Barge_Updated.pdf",
    "url":"https://sam.gov/api/prod/opps/v3/opportunities/resources/files/ae7bb576c91d4083a365933b04db93b4/download",
    "mime_type":".pdf",
    "size_bytes":231136,
    "access_level":"public",
    "export_controlled":false
  }]
}

Attachments include their type, name, URL, source file type, size in bytes, posting time, access level, and export-control indicator. File URLs point to a stable SAM.gov download route; external links keep their published destination. Files are not downloaded, and deleted attachments are excluded. Access restrictions still apply when you follow a link.

The run output reports counts, warnings, and whether collection was partial. A requested detail or attachment phase that fails is reported explicitly, while any available notice rows remain usable. Check details_fetched before treating absent classification or award fields as confirmation that the source has no such data. Search totals can exceed the source window; narrow your filters to collect other portions of a large result set.

SAM.gov API vs this actor

	Official SAM.gov Opportunities API	SAM.gov website search	This actor
API key	Required, tied to a SAM.gov account	Not needed	Not needed
Request limits	Daily limits per key	Manual paging	Bounded batches, cursor continuation handled for you
Award UEI and CAGE	Per award record	Visible per notice, by hand	In the award row
Attachments	Download links	Per notice, by hand	Name, size, type, access level and download URL in the row
Output	Nested JSON	Screen or CSV export	Flat dataset: JSON, CSV, Excel or API

Compared with other SAM.gov scrapers in the Apify Store, this actor combines search filters, direct notice IDs, the full agency hierarchy, attachment metadata and award identifiers in one row, charges only for delivered notices, and continues large selections automatically.

Pricing

The actor uses one opportunity event per delivered notice. Full details and attachment metadata belong to that notice; they do not create extra dataset rows or separate attachment charges. Duplicate records are charged once. Empty results and unknown IDs produce no row charge. The Store pricing panel shows the current price per opportunity, so 1,000 delivered notices cost 1,000 times that amount.

Users without a paid Apify plan receive at most ten notices per run. The actor stops collecting once that limit is reached. Paid users can request the full configured volume, subject to the source window and available notices. Your Apify usage budget can also stop a run; consult the run output for the rows actually delivered.

FAQ

Do I need a SAM.gov API key?

No SAM.gov API key is required for this actor. Supply the search filters or notice IDs as actor input.

Can I collect archived awards?

Yes. Set status to archived or all and include notice type a or Award Notice. Award fields depend on the information published by the contracting office.

What is the difference between a notice ID and a solicitation number?

A notice ID identifies one SAM.gov publication. A solicitation number is the procurement reference and may appear on several related notices. Use notice_ids for specific publications and keywords to search a solicitation number.

How do I find small-business set-aside opportunities?

Set set_aside_codes to the programs you qualify for, such as SBA, 8A, WOSB or SDVOSBC, and combine them with naics_codes and a response_from date so that only open opportunities with a future deadline remain.

Are full descriptions and attachments always available?

Their availability depends on the notice and its access rules. Full descriptions require details; files are returned as links and metadata. Failures appear in warnings. A null place of performance means SAM.gov supplied no usable location, rather than an inferred office address.

How are large runs collected?

The actor collects notices in bounded batches and follows continuation cursors automatically. Returned positions continue through the run, and repeated notice IDs are removed. Live search results can change while collection is underway, so narrow date and agency filters when you need a reproducible selection.

Can I schedule daily alerts for new contract opportunities?

Yes. Create an Apify schedule with your filters; results are ordered by latest modification, so each run starts with the newest notices. Deduplicate on notice_id against earlier runs, and connect the dataset to email, Slack, Google Sheets or a webhook through Apify integrations.