USAspending.gov API

Overview

USAspending.gov serves as the official public source for tracking federal spending across the United States government. Established in 2007, its primary objective is to enhance transparency and accountability by providing detailed information on how taxpayer dollars are allocated and utilized. The platform aggregates data from various federal agencies, offering insights into contracts, grants, loans, and other financial assistance programs.

The system is designed for a broad audience, including developers, data scientists, researchers, journalists, and the general public. Developers can utilize the USAspending.gov API to programmatically access and integrate federal spending data into custom applications, dashboards, or analytical tools. This programmatic access supports automated data retrieval and analysis, which can be critical for large-scale research or continuous monitoring projects.

USAspending.gov shines particularly in scenarios requiring detailed financial transparency and oversight. For example, it enables users to trace funding from federal agencies down to specific recipients, such as companies, non-profit organizations, or state and local governments. This level of granularity supports investigative journalism, academic research into government efficacy, and public policy analysis. The data includes information on award amounts, recipient details, funding agencies, and descriptions of the goods or services procured. The structured nature of the data, while complex due to the intricacies of government finance, allows for targeted queries and aggregations.

The platform's utility extends to technical buyers and organizations that need to understand government procurement trends, identify potential contracting opportunities, or analyze the economic impact of federal investments. By providing a centralized, standardized repository of federal spending information, USAspending.gov reduces the effort required to gather disparate government financial reports, offering a consolidated view that was previously difficult to obtain. The data is updated regularly, reflecting ongoing federal financial activities.

Key features

• Comprehensive Federal Spending Data: Provides access to detailed information on contracts, grants, loans, and other financial assistance from across the U.S. federal government, as outlined in the USAspending.gov data sources.
• Award Data Access: Users can retrieve specific details about individual awards, including recipient names, award amounts, funding agencies, and descriptive project information.
• Account Data Access: Offers insights into federal agency accounts, allowing for analysis of budget allocations and expenditures at a higher level.
• Search and Filtering Capabilities: The platform and API support extensive filtering options to narrow down data by agency, recipient, award type, location, time period, and other relevant criteria.
• Data Downloads: Users can download filtered datasets in various formats directly from the website, facilitating offline analysis.
• Interactive Visualizations: The USAspending.gov website includes interactive dashboards and charts to visualize spending trends and patterns.
• API for Programmatic Access: A RESTful API enables developers to programmatically query and retrieve federal spending data for integration into custom applications and analytical tools, with detailed endpoint documentation.
• Data Dictionaries: Comprehensive data dictionaries are provided to explain the meaning and structure of the various data fields available through the API and downloads.

Pricing

USAspending.gov provides public access to all its data and API services at no cost. The platform is maintained by the U.S. Department of the Treasury and is designed as a public resource for government transparency.

Common integrations

Developers often integrate USAspending.gov data into custom analytical platforms or visualization tools. While there are no official third-party integrations listed by USAspending.gov, common integration patterns include:

• Business Intelligence (BI) Dashboards: Integrating spending data into tools like Tableau, Power BI, or custom dashboards for trend analysis and reporting.
• Data Warehouses and Databases: Extracting data via the API and loading it into a data warehouse for long-term storage and complex querying alongside other datasets.
• Research Applications: Building specialized applications for academic or journalistic research to analyze specific aspects of federal spending.
• Public Policy Analysis Tools: Developing tools to assess the impact of government programs or track expenditures related to specific policy initiatives.
• Government Transparency Portals: Incorporating federal spending data into local or state government transparency initiatives.

Alternatives

• OpenGovernment.org: A non-profit initiative that aggregates government data, including spending, for transparency and civic engagement.
• Data.gov: The primary U.S. government open data portal, which hosts various federal datasets, some of which overlap with spending data.
• ProPublica Data Store: Offers curated datasets, including some related to government contracts and financial disclosures, often with journalistic analysis.
• Federal Procurement Data System – Next Generation (FPDS-NG): The authoritative source for federal procurement data, focusing specifically on contract actions.
• Congressional Research Service (CRS) Reports: While not a data API, CRS provides in-depth analysis and data visualizations on federal spending and budget topics, often citing underlying data sources.

Getting started

To begin retrieving data from the USAspending.gov API, you can make a simple HTTP GET request. The API does not require authentication for public data access. The following Python example demonstrates how to fetch a list of federal agencies:

import requests
import json

# Define the API endpoint for agency data
agencies_endpoint = "https://api.usaspending.gov/api/v2/references/toptier_agencies/"

try:
    # Make a GET request to the API
    response = requests.get(agencies_endpoint)
    response.raise_for_status() # Raise an exception for HTTP errors (4xx or 5xx)

    # Parse the JSON response
    data = response.json()

    # Print the names of the first few agencies
    print("Successfully retrieved agency data. Top agencies:")
    for agency in data.get('results', [])[:5]: # Get first 5 agencies
        print(f"- {agency.get('agency_name')}")

except requests.exceptions.RequestException as e:
    print(f"An error occurred: {e}")
except json.JSONDecodeError:
    print("Failed to decode JSON from response.")

This script connects to the top-tier agencies endpoint and prints the names of the first five agencies returned. For more complex queries, developers should consult the full API documentation to understand available parameters, filtering options, and data structures for specific endpoints like award data or account data. The API supports various filters to refine searches, such as filtering by fiscal year, agency ID, or recipient name, enabling targeted data retrieval for specific analytical needs.