Auth
headers: { 'Authorization': 'Replace with your API token' }
Examples
fetch('https://api.gurufocus.com/data/download/list', { method: 'GET', headers: { 'Authorization': 'Replace with your API token' }})
Responses
Successful response. The exact payload fields depend on this endpoint.
Example Body (Field Reference)
No response body is documented for this status.
Path Parameters
| Name | Type | Example | Description |
|---|---|---|---|
| id | string | - | Package ID |
Auth
headers: { 'Authorization': 'Replace with your API token' }
Examples
fetch('https://api.gurufocus.com/data/download/url/ID', { method: 'GET', headers: { 'Authorization': 'Replace with your API token' }})
Responses
Successful response. The exact payload fields depend on this endpoint.
Example Body (Field Reference)
No response body is documented for this status.
Introduction
The Bulk Download API provides direct access to the stock data packages available to the current user. Use /download/list to discover what can be downloaded, then call /download/url/{id} to fetch a signed URL for the selected ZIP file.
This endpoint is intended for bulk data access and follows the same packaging rules used by our internal data production pipeline.
Important Notice
Bulk download access is available only to selected customers. If you need access for your account or organization, please contact us to discuss eligibility and enablement.
Response Reference
List Response
| Display Name | Field Name | Data Type | Description |
|---|---|---|---|
| Package ID | id | string | Unique package identifier used by /download/url/{id}. |
| Category | category | string | Data category, currently stock. |
| Region | region | string | Region code such as U, A, B, E, or O. |
| Package Name | name | string | Dataset name such as profile, rankings, fundamentals, valuations, or segment. |
| File Name | file_name | string | ZIP file name for the package. |
| Updated At | updated_at | datetime | Package generation timestamp in UTC. |
| Type | type | string | Package type: daily, delta, or monthly. |
Download URL Response
| Display Name | Field Name | Data Type | Description |
|---|---|---|---|
| Package ID | id | string | Unique package identifier for the requested package. |
| Signed URL | url | string | Signed URL used to download the package ZIP file. |
| Expiration | expiration | datetime | Expiration time for the signed URL. |