How to Export a Dataset of Articles from the Dashboard
Create a large news download from the Datasets page
Written by Erick Horn
September 3, 2026
Updated October 16, 2026
How to export a dataset of articles from the dashboard
Open Datasets in the dashboard to download up to 1,000,000 articles in one file. Choose your filters and dates, check the estimate, then create the export. Datasets require Basic or above and cost 1,000 requests per export.

What is a dataset export?
A dataset is a bulk download in JSONL, CSV or Parquet. It can include far more articles than a single API export, with fields such as entities, sentiment, categories and translations.
Choose your search once and download the finished file when it is ready. The file stays available for seven days.
How do I create a dataset?
- Open Datasets and click Create dataset.
- Add an optional name and choose JSONL, CSV or Parquet. Without a name, the dataset uses its date range.
- Choose a publication date range in UTC, up to 366 days.
- Set your filters: keywords, language, category, country, source, sentiment or advanced search.
- Check Price & estimate. It updates after you change the search and shows how the export will be paid for.
- Preview the first five articles.
- Click Create dataset. The export enters the queue, the charge is applied once, and its details page opens.

How much does a dataset cost?
Each export costs 1,000 requests, whether it contains 50 articles or one million. Estimates and previews are free. Building the file adds no further charge.
If your plan has at least 1,000 requests left, the form shows Covered by your quota. Otherwise, the export can use $10 of pay-as-you-go balance if pay-as-you-go is enabled and your monthly limit allows it.
If neither option covers the charge, the form shows Not enough credits and disables creation. A technical failure refunds the 1,000 requests and shows Refunded. Cancelling an export does not refund the charge.
What does the preview show?
The preview shows the first five matching articles, starting with the oldest publication date. It lists each article’s ID, date, headline, source domain and language, plus the number of fields in the full record.
After changing a filter, click Refresh preview to check the new results.

How do I follow progress and download the file?
Open the dataset’s details to see its status: Queued, Running, Finalizing, Ready, Failed, Canceled or Expired. The page shows progress, article count, estimate and price.
Small exports can finish in minutes; larger ones can take hours. When the status becomes Ready, click Download. The button shows the file size. You also receive a dashboard notification and an email.
Download within seven days. The page shows the exact expiry time.

Only one export can run at a time per account. While it is active, Create dataset is disabled and the list shows its progress. Cancel an active export from its details or the list’s actions menu. Deleting a finished export removes both the file and its entry in the list.
Which file formats are available and how are they packed?
- JSONL (
.jsonl.gz): one complete article object per line, compressed with gzip. - CSV (
.csv.gz): a gzip-compressed table with the API’s CSV columns. Nested fields, such as source, entities and translations, are JSON strings inside cells. - Parquet (
.parquet): a compressed file for tools such as pandas, DuckDB and Spark. Nested fields are JSON strings.
Articles appear once each, in ascending published_at order.
Can I edit or re-run an export?
Click Edit & re-run on a finished, failed or cancelled export. The form opens with its name, format, dates and filters filled in. Change what you need, then create a new export.
Each re-run is a new order and costs another 1,000 requests.
Common Questions
- Why is the Create dataset button disabled?
- Do title searches still have the 31-day limit?
- Who in my workspace can create and download datasets?
- Is the export written to the audit log?
Why is the Create dataset button disabled?
The estimate must be current and the export must be payable. The button stays disabled while the count updates, above 1,000,000 matching articles, while another export is active, on plans below Basic, or when your quota and pay-as-you-go balance cannot cover the charge.
If the count is too high, narrow the date range or add filters.
Do title searches still have the 31-day limit?
A dataset can cover up to 366 days, including searches with title or query. You do not need to split it yourself. Regular News API title and query requests still have a 31-day date-window limit.
Who in my workspace can create and download datasets?
Owners, admins and members can create exports. Viewers can open the page and download ready files.
Members can cancel or delete their own exports. Owners and admins can manage every export. The workspace owner’s quota or balance pays for each one.
Is the export written to the audit log?
Yes. Creating, cancelling, downloading or deleting a dataset adds an entry to the workspace Audit log. It records the person, dataset name and details such as format and estimated article count.