Piloterr

USAspending Search

GET
/v2/usaspending/search

Search US federal awards by keyword. award_type selects one group: contract (default), grant, idv, or loan. Amounts are a number plus a display string.

Credit cost: 1 credit per call

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

Required. Keyword or a usaspending.gov search URL. Example: software. An award URL returns 400.

award_type?string

Optional. One group: contract (default when omitted), grant, idv, or loan. Example: grant.

page?number

Optional. Page number from 1. Example: 2. Defaults to 1. Each page has 10 awards. total_results stays null.

Response Body

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/usaspending/search?query=string'
Example Response
{  "results": [    {      "url": "https://www.usaspending.gov/award/CONT_AWD_GSFC0198106DNAS526555_8000_-NONE-_-NONE-/",      "city": null,      "state": null,      "award_id": "GSFC0198106DNAS526555",      "end_date": "2026-10-31",      "psc_code": null,      "award_type": null,      "naics_code": null,      "start_date": "1987-09-15",      "description": "THE PRIMARY ACTIVITIES COVERED BY THIS EFFORT INCLUDE THE FINAL SERVICING MISSION AND SUBSEQUENT OPERATIONS THROUGH END-OF-MISSION. THESE ACTIVITIES INCLUDE: A. SCIENCE PROGRAM IMPLEMENTATION INCLUDING: MISSION PLANNING SUPPORT, SCIENCE PROGRAM DEFINITION SUPPORT, MANAGEMENT OF THE PROPOSAL SELECTION, TIME ALLOCATION, AND GRANT AWARD COMMITTEE PROCESSES, AND SCIENCE COMMUNITY OUTREACH. B. ROUTINE SCIENCE OPERATIONS INCLUDING: PROPOSAL GENERATION AND RECEIPT, OBSERVATION PLANNING AND SCHEDULING, UPDATING INSTRUMENT HANDBOOKS, OBSERVING AND USER SUPPORT, DATA PROCESSING AND PRODUCT GENERATION, ARCHIVAL AND DATA DISTRIBUTION SERVICES, CALIBRATION ASSISTANCE AND DATA ANALYSIS, ANOMALY INVESTIGATION SUPPORT, USER GRANT ADMINISTRATION, OBSERVER ASSISTANCE AND ENGINEERING OPERATIONS SUPPORT. C.",      "award_amount": 2533788480,      "amount_display": "$2,533,788,480.00",      "funding_agency": "National Aeronautics and Space Administration",      "recipient_name": "ASSOCIATION OF UNIVERSITIES FOR RESEARCH IN ASTRONOMY, INC.",      "awarding_agency": "National Aeronautics and Space Administration",      "awarding_sub_agency": "National Aeronautics and Space Administration",      "generated_internal_id": "CONT_AWD_GSFC0198106DNAS526555_8000_-NONE-_-NONE-"    }  ],  "pagination": {    "next": "https://www.usaspending.gov/search/?keywords=software&page=2",    "page": 1,    "per_page": 10,    "total_pages": null,    "total_results": null  }}