ActorStack.dev

You do not need a SAM.gov API key, and asking for one is a design smell

Several SAM.gov scrapers require you to register for an api.sam.gov key. That moves the quota problem, the approval wait and the renewal onto you — for data that is public either way.

By Oswaldo Carabano6 min read

Short answer

SAM.gov does publish an official opportunities API that requires a registered key with a quota. It is not the only public route: the endpoint the SAM.gov search page itself calls is public and needs no credential, which is what this Actor uses. A tool that requires your key hands you the registration wait, the quota ceiling and the renewal — and then stops working for reasons that are yours rather than its.

Key points

  • There is an official keyed API, and there is also the public endpoint the site's own search page uses.
  • A tool built on your key inherits your quota: the failure arrives when you are busiest and looks like the tool's fault.
  • A key is also an approval wait before the first run, which is a poor first experience for evaluating a tool.
  • The data is public either way — FAR Part 5 requires agencies to publicise these notices.
  • No credential means nothing expires, which is the same reliability argument the other Actors on this site make.
On this page6 sections

Several SAM.gov scrapers begin with the same instruction: register at api.sam.gov, wait for approval, paste your key here. It sounds like diligence. It is the tool handing you its hardest operational problem.

Two public routes, one of them keyed

GSA publishes an official opportunities API. It is real, documented, and it requires a registered key with a quota. That is the right choice for some integrations and this article is not an argument against it existing.

There is also the endpoint the SAM.gov search page itself calls when a member of the public searches for contracts. It needs no credential, because the search page needs none. That is what this Actor reads.

What requiring a key actually costs you

Three things, in the order you meet them:

  1. An approval wait before the first run. You cannot evaluate the tool today.
  2. A quota you own. The ceiling is on your key, not on the tool.
  3. A renewal you will forget. Keys expire, and the pipeline fails when it does.

The quota problem is transferred, not solved

This is the part worth being precise about. A keyed tool has not removed the rate limit — it has moved the limit onto an account you administer, so that when it binds, the failure arrives as your misconfiguration.

Why this data is public in the first place

Because publication is the point. FAR Part 5 requires agencies to publicise contract actions precisely so that businesses can find them, and U.S. Government works are not subject to copyright under 17 U.S.C. § 105.

That is unusual and worth appreciating: most of what this site documents is public in the weak sense of “visible if you look”. Federal notices are public in the strong sense of “published because a rule says they must be” — what that settles and what it does not.

When the official API is the right choice

If you need a supported contract with a versioning policy and someone to escalate to, use the keyed API. That is what it is for, and a public endpoint carries none of those guarantees.

The honest summary of the trade: the keyed API gives you a contract and a quota; the public endpoint gives you no contract and no credential to manage. This Actor takes the second, and says so rather than implying there is no first.

Reading a public endpoint responsibly

No credential is not a licence to hammer it. The Actor keeps to 4 concurrent requests with a one-second delay, fetches robots.txt on every single run, and enforces it in the request layer so a disallowed path is never requested.

SAM.gov is public infrastructure paid for by taxpayers. Treating a rate limit's absence as permission to consume it is the behaviour that gets public endpoints closed.

Frequently asked questions

Is there an official SAM.gov API?
Yes, GSA publishes an opportunities API that requires a registered key with a quota. This Actor does not use it; it reads the public endpoint the SAM.gov search page itself calls, which needs no credential.
Why is requiring my API key a problem?
Because it transfers the quota, the approval wait and the renewal to you. When the quota runs out the tool stops working for a reason that is yours, and the first run cannot happen until an approval arrives.
Is reading the public endpoint allowed?
It serves the public search page, and the notices are published under a legal requirement that agencies publicise them. This Actor also fetches robots.txt on every run and enforces it in the request layer, and keeps to 4 concurrent requests with a one-second delay.

Sources

Every URL below was requested and returned a page on the date shown.

  1. Platform docschecked 19 Aug 2026
    Get Opportunities Public APIGSA Open Technology
  2. Operator claimchecked 19 Aug 2026
    SAM.gov Data ServicesSAM.gov (U.S. General Services Administration)
  3. Site declarationchecked 19 Aug 2026
    sam.gov/robots.txtSAM.gov (U.S. General Services Administration)
  4. Law or regulatorchecked 19 Aug 2026
    FAR Part 5 — Publicizing Contract ActionsAcquisition.gov (U.S. Federal Acquisition Regulation)
  5. Operator claimchecked 19 Aug 2026
    SAM.gov Federal Contract Opportunities & Attachments — Actor README and input schemaActorStack / Apify Store
A desk with stacked legal reference books, loose documents and a newspaper.
SAM.govExplainer

Is it legal?

Federal notices are published because the law requires agencies to publicise them, and U.S. Government works carry no copyright. That settles more than usual — and not everything.

7 min
The dome of the United States Capitol against a clear sky.
SAM.govGuide

Opportunity monitoring

A working monitoring pipeline: what to filter, how often to run, which deadline field to schedule against, and where the attachment rate changes your plan.

8 min
The dome of the United States Capitol against a clear sky.
SAM.govGuide

Scrape SAM.gov

A walkthrough of extracting U.S. federal contract notices: which filters actually narrow the index, how to get the solicitation documents, and why there are three deadline fields.

9 min