The Query Generator is a flexible tool to help users create their API calls. You must register before you can see any results from API calls, even in the Query Generator. The Query Generator does not include every feature that the API offers. For complete documentation on the API, see our Input Reference, Output Reference and Message Reference. Included in the Input Reference is documentation on how to get a complete list for our topics, programs, series, etc.
Flexible Query Strings are configurable http requests that accept parameters that will inform the API's response.
The following application was developed to introduce the NPR library aggregations and their associated codes. The codes are appended to the url string to create the http request that will return the data in the chosen xml format. The below library represents a recent catalog of NPR stories. For an index of the NPR library available via the API, please see the Mapping Index.
- In the following form, select the values to append as parameters on the query string.
- Add any additional selection criteria, such as data range, or search terms, located in the Additional tab.
- Be sure to select your desired format on the Fields tab.
- Once your selections are chosen, create the query string by clicking the Create API Call.
- This will generate the query string.
- You may return the results of your selection by clicking the Execute API Call, or you may cut and paste the url query string into a browser's address bar.
- If you using date ranges or select the number to return, you may amend these values directly in the query string.