APITube Help Center

How to Export a Dataset of Articles from the Dashboard

Create a large news download from the Datasets page

Erick Horn

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.

Free and Starter accounts can view the Datasets page. Upgrade to Basic or above to create an export.

The Datasets page of the APITube dashboard: the Datasets entry in the Develop section of the sidebar, a note that files are kept for 7 days and one dataset costs 1,000 requests, and a table of finished exports with format, status, article count and expiry date

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?

  1. Open Datasets and click Create dataset.
  2. Add an optional name and choose JSONL, CSV or Parquet. Without a name, the dataset uses its date range.
  3. Choose a publication date range in UTC, up to 366 days.
  4. Set your filters: keywords, language, category, country, source, sentiment or advanced search.
  5. Check Price & estimate. It updates after you change the search and shows how the export will be paid for.
  6. Preview the first five articles.
  7. Click Create dataset. The export enters the queue, the charge is applied once, and its details page opens.

The New dataset form: a date range of March 1–6, 2026, the filter builder with title, language, category, country, source domain and sentiment fields, and the Price & estimate card showing a flat price of 1,000 requests, 4,010 matching articles and the note that the price is covered by the plan quota

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.

The Preview card under the form: a five-row table with article ID, published time, title, source domain and language, and the note that each row has 33 fields

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.

The detail page of a finished dataset: status Ready, format JSONL, 248 articles, price 1,000 requests from quota, a complete progress bar and the Edit & re-run, Download (1.4 MB) and Delete buttons

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?

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.


Related Articles