citature¹

$0.02 / answer

Federal award spending ranked by agency, place-of-performance state, or recipient.

Run federal-awards on Apify

What it answers

Federal contract-award dollars for a U.S. fiscal year, ranked by awarding agency, by place-of-performance state, or by recipient. Data comes straight from USAspending.gov — the primary, public-domain record of federal awards — with totals in integer cents and award counts alongside. Recipients are identified by their federal UEI, agencies by their official toptier names, and every ranking arrives with the exact source query, retrieval timestamps, and coverage caveats. Built for anyone who needs a federal spending number they can defend.

Ask it things like

  • Which agencies have obligated the most contract dollars in FY2026 so far?
  • Which states received the most federal award spending by place of performance?
  • Who were the top federal contract recipients, by UEI, in FY2025?
  • How much did the Department of Defense obligate across contract awards in FY2025?
  • Rank universities and nonprofits among federal award recipients.

What comes back

Every response is a receipt: the answer plus citations (the exact upstream query URL, independently re-runnable, with retrieved_at and the source's own as_of — two clocks, never collapsed), coverage caveats, matches declaring how any cross-source join was made, and a schema_version you can pin.

{
  "answer": [
    {
      "fiscal_year": 2026,
      "agency_entity_id": "agcy_db79c75ee604aa446a37",
      "agency_name": "Department of Homeland Security",
      "total_cents": 3552473819501,
      "award_count": 46
    },
    {
      "fiscal_year": 2026,
      "agency_entity_id": "agcy_7acf916f717cccf02850",
      "agency_name": "Department of Veterans Affairs",
      "total_cents": 3168937118677,
      "award_count": 50
    }
  ],
  "citations": [
    {
      "source": "usaspending",
      "source_label": "USASpending.gov",
      "query_url": "https://api.usaspending.gov/api/v2/search/spending_by_award/?time_period=2024-01-01..2026-07-08&page=50",
      "retrieved_at": "2026-07-10T04:53:32.231Z",
      "as_of": null,
      "cache": "cached",
      "record_id": null
    }
  ],
  "coverage": [
    "Coverage reflects records currently in citature's dataset, not the full upstream history.",
    "An award's fiscal year is derived from its action/start date; a contract begun in an earlier year appears under that year, not the year it was retrieved."
  ],
  "guardrails": [
    "Research over public-domain federal records — not legal, financial, or eligibility advice.",
    "citature reports what the record says. It never renders a compliance verdict, a screening pass/fail, or a recommendation.",
    "Entity-level records only (committees, candidates, recipients, agencies, contracts). No individual-person data."
  ],
  "matches": [
    {
      "match_method": "exact",
      "match_confidence": 1,
      "left_key": "usaspending.awarding_agency",
      "right_key": "citature.entity_agency.agency_name",
      "note": "agency resolved to a citature entity on the toptier awarding-agency name the award summary exposes"
    }
  ],
  "schema_version": "0.1.0"
}
an abbreviated receipt from a real run · retrieved 2026-07-10

Input

paramtyperequirednotes
fiscal_yearintegeryesU.S. fiscal year, e.g. 2026.
group_by"agency" | "state" | "recipient"noHow to rank; default agency.
limitinteger 1–500noMax ranked rows; default 50.

Pricing

$0.02 / answer — metered per served answer on the Apify platform. Invalid input is never charged.

Run it

  1. 1 · on Apify (the console)

    The listing has worked examples, the input form, and per-run output.

    Run federal-awards on Apify
  2. 2 · via the Apify API

    curl -X POST "https://api.apify.com/v2/acts/citature~federal-awards/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{"fiscal_year":2026,"group_by":"agency","limit":5}'
  3. 3 · over MCP

    The same answer serves as awards_by_agency, awards_by_state, awards_by_recipient on the citature MCP server.

guardrails & coverage

  • Research over public-domain federal records — not legal, financial, or eligibility advice.
  • citature reports what the record says. It never renders a compliance verdict, a screening pass/fail, or a recommendation.
  • Entity-level records only (committees, candidates, recipients, agencies, contracts). No individual-person data.
  • Coverage reflects the records in citature's dataset, not the full upstream history. The ingest runs nightly and advances each dataset when its source publishes.
  • Every answer states its own coverage caveats in the receipt's `coverage` field.