APITube Help Center

Test keys vs live keys

Choose test mode for development and live mode for normal usage

Kent Hudson

Written by Kent Hudson

June 28, 2026

Updated October 16, 2026

Open this example in the API Playground ↗

Test keys vs live keys

Use a test key to build an integration without spending quota. It returns article previews from the same API. Use a live key for normal usage and billing; full article text also requires a paid plan.

# Same endpoint, same shape — only the key's prefix changes the behaviour
curl "https://api.apitube.io/v1/news/everything?per_page=10&api_key=api_test_YOUR_TEST_KEY"

Filters, pagination and field selection let you test the request flow before switching keys. Some aggregate results are limited in test mode.

How do you tell a test key from a live key?

Test keys start with api_test_; live keys start with api_live_. Both use the same endpoint URLs and authentication methods.

Check x-apitube-mode in the response to confirm which mode your request used:

x-apitube-mode: test
x-apitube-mode: live

What does a test key return differently?

Article body and body_html are shortened to a 200-character preview and marked [Test mode — use a live key for full content]. Titles, descriptions, URLs, source data and structured article fields remain complete.

/v1/news/count caps its answer at 100. /v1/news/trends hides entry labels in value. Test keys also work with SSE and WebSocket, returning preview article text without spending quota.

See masked results for examples.

Do test keys count against my quota or rate limit?

They do not spend request quota, streaming quota or pay-as-you-go balance. An empty quota does not produce an out-of-funds error for a test request.

Test requests are still limited to 15 per minute. Live limits are 10 on Free, 50 on Starter, Basic and Professional, and 200 on Corporate. Repeated rate-limit violations can cause a temporary 429 ban. Test your wait-and-retry handling too.

How do you create or switch between test and live keys?

In the APITube dashboard, select Test mode, open API Keys and click Create key. Turn Test mode off to create a live key. Each mode shows its own keys; changing mode does not convert existing keys.

The Test mode toggle at the bottom of the dashboard sidebar

See how to manage keys and the official authentication reference.

Common Questions

Can I use a test key in production?

Use a live key for production. Test keys return preview text, limited aggregate results and a 15-per-minute request limit. Choose a paid plan if your app needs full article text.

Do test keys respect IP, referrer and scope restrictions?

Yes. Restrictions apply in both modes. A blocked request returns 403 ER0601 for IP, ER0602 for referrer or ER0603 for scope.

Can a test key expire?

Yes. Its expiry works the same way as a live key’s. An expired key returns 401 ER0230.

Does my code need to change when I switch from test to live?

Replace the key in your app’s configuration. The endpoint URLs and response structure stay the same. Normal billing starts, and your plan determines content access and limits.


Related Articles