usaspending-api-helper

Query and filter USA Spending API award data with v2/search endpoints.

Updated Dec 13, 2025
One-click install
npx skills add https://github.com/WebDev70/hosting-google --skill usaspending-api-helper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: usaspending-api-helper
Source: https://github.com/WebDev70/hosting-google/tree/main/.claude/skills/usaspending-api-helper
Command: npx skills add https://github.com/WebDev70/hosting-google --skill usaspending-api-helper

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides expert knowledge for integrating with the USA Spending API, including how to build effective filters, interpret award type codes, and navigate API endpoints, reducing guesswork and debugging time.

Core Features & Use Cases

  • Build and validate API request payloads for spending_by_award and spending_by_award_count.
  • Understand and map Contract, Grants, and IDV award type codes to API requests.
  • Debug production responses and extend search functionality for custom analytics.

Quick Start

Use the USA Spending API Helper to craft a basic search payload and POST it to the API's search endpoint to retrieve spending by award. For example, include a date range, selected award types, and agency filters to verify results.

Frequently Asked Questions about usaspending-api-helper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build filters for the USA Spending API spending_by_award endpoint?

To build filters for the USA Spending API, construct a POST request payload for the v2/search/spending_by_award endpoint that includes date ranges, agency selections, and valid award type codes to retrieve specific contract, grant, or IDV data.

What are the valid award type codes for contracts, grants, and IDVs in the USA Spending API?

Valid award type codes for contracts, grants, and IDVs in the USA Spending API are required to filter spending_by_award requests correctly, ensuring the response accurately maps to the selected federal award categories.

How do I retrieve a count of awards using the USA Spending API?

To retrieve an award count using the USA Spending API, POST your validated filter payload to the v2/search/spending_by_award_count endpoint to get the total number of matching records.

Why does my USA Spending API request return unexpected or empty award data?

Unexpected USA Spending API responses often occur when award type codes are incorrectly mapped or required filter parameters like date ranges are missing from the spending_by_award payload, requiring response debugging.

Can I use the USA Spending API to build custom analytics for federal contracts and grants?

Yes, you can use the USA Spending API for custom analytics by extending search functionality and combining multiple filter parameters in spending_by_award requests to query specific federal contract and grant data.

Do I need API authentication to query production search endpoints on USA Spending?

Querying the USA Spending API production search endpoints like spending_by_award requires knowing the valid request payload structure and award type codes, though the API is publicly accessible for retrieving federal award data.