Run Multiple Queries in a Single Request
This advanced feature of the API Connector add-on for Google Sheets enables you to stack multiple request URLs together and run them one after the other as a unified block. API Connector will cycle through the URLs and print out the results one after another in a single sheet.
This is a paid feature, please upgrade to access.
- Why Use the Multi-Query Function?
- Example 1: List URLs in the URL input box
- Example 2: Reference Cells
- Example 3: Reference a Range of Cells
- Multi-query requests are commonly used to account for simple API pagination, in which an API limits the number of records returned in each response and requires you to make multiple requests to retrieve the full set of data. There are two common methods of pagination that can be managed via multi-query requests:
■ pagination parameters:
■ offset-based pagination:
- Multi-query requests can also be used to query the same (or similar) API endpoint multiple times, e.g. for different company IDs, different stock symbols, different time periods, etc.
To run multiple requests, list your URLs on separate lines. When you Run the request, each subsequent response will be appended to the first empty row.
You can reference cells in the input box (info). Again, make sure each separate request is on a new line, to ensure API Connector recognizes it as a new request:
Example 3: Reference a Range of Cells
As a shorthand method, instead of referencing cells one by one, you can reference them as a range, like this:
As shown in the screenshots above, when you reference a cell, you can reference the entire URL or part of the URL.
- When you stack requests, response data from each query will be sent to a single sheet, with each subsequent request appended to the first empty row.
- When running multiple queries, a 1.4 second delay is automatically inserted between requests to avoid rate limits.
- When using +++ referencing, make sure you select the correct sheet. By default, this referencing would look something like +++Sheet1!A1:A10+++
- There’s no specific limitation on stacking GET vs POST/PUT requests, but only the URL field accepts stacked URLs, which may limit its usefulness for POST requests.
- For more robust pagination handling, try the pagination function.