How to use the APITube Postman collection#

The APITube Postman collection is a ready-made set of News API requests you import into Postman, point at your own key, and run — no code required. Open the public collection at postman.com/apitube/apitube, add it to your workspace, set one api_key variable, and every request is ready to send against https://api.apitube.io.

It bundles 142 ready-to-run requests: the core endpoints at the top level plus an Examples folder of themed filter recipes. Because each request is pre-built with the right URL and parameters, it is the fastest way to learn the API surface hands-on before you write a single line of client code.

How do you import the APITube Postman collection?#

The collection is published to the public APITube Postman workspace. Open postman.com/apitube/apitube/overview and use Postman’s Fork or Import action to copy it into your own workspace. Once it lands in your sidebar, you will see the collection named “APITube - News API” with every request grouped and ready.

Every request already targets the live base URL, so there is nothing to configure except your key:

https://api.apitube.io/v1/news/everything?api_key={{api_key}}

How do you set your API key in Postman?#

Every request in the collection reads a Postman variable called api_key and appends it as the api_key query parameter (?api_key={{api_key}}). Set that variable once — as a collection variable or an environment variable — to your own key, and all 142 requests inherit it.

1. Grab your key from the dashboard — see where to find and create your API key.
2. In Postman, open the collection’s Variables tab (or create an environment), add api_key, and paste your key as the value.
3. Send any request — for example Check balance (GET /v1/balance) — to confirm the key resolves.

If you prefer sending the key as a header instead of a query parameter, the API also accepts an X-API-Key header. A missing key returns 401 ER0201 (“API key is required”), and an invalid one returns 401 ER0202.

What requests are included in the collection?#

The top level of the collection covers the main endpoints, each pre-filled and ready to send:

• Everything — the main search endpoint (POST /v1/news/everything, sent as JSON). Its optional filters (title, language.code, category.id, topic.id and many more) ship pre-filled but disabled — flip the toggle next to any parameter to activate it.
• Top headlines, and browse-by requests: Get news by category / topic / industry / entity.
• Get article by ID and Get story by ID to fetch a single article or a whole story cluster.
• Get trends, plus Trends with trending score, Trends with period comparison and Trends by time bucket.
• Suggest entities for autocomplete (a prefix such as Apple, an optional type like organization, and a limit).
• Check balance to read your remaining quota.

How do you use the Examples folder?#

The Examples folder is where the collection earns its keep: 16 themed sub-folders of copy-and-run filter recipes, so you can see the exact parameter syntax for each feature. The sub-folders are Filters, Sorting, Geolocation, Readability, Read Time, Faceting, Highlighting, Disasters & Events, Clickbait Detection, Breaking News, Export Formats, Pagination, Persons, Organizations, Brands and Field Selection.

Each example is a real, working request. A few to try:

# Geolocation → Search by bounding box
GET /v1/news/everything?api_key={{api_key}}&location.bbox=34.0,-118.5,34.3,-118.1

# Clickbait Detection → Detect clickbait articles
GET /v1/news/everything?api_key={{api_key}}&is_clickbait=1

# Export Formats → Export as CSV
GET /v1/news/everything?api_key={{api_key}}&export=csv

# Field Selection → Minimal response
GET /v1/news/everything?api_key={{api_key}}&fl=id,title,href

Trim the response to only the fields you need with fl — see how to select specific response fields. The full parameter list behind every example lives in the official News API parameters reference.

Common Questions#

• Where do I download the APITube Postman collection?
• Why do my requests return a 401 error in Postman?
• Do I have to enable each parameter by hand?
• Can I use the collection without writing code?

Where do I download the APITube Postman collection?#

The collection is hosted on the public APITube Postman workspace at postman.com/apitube/apitube/overview. Fork or import it from there into your own workspace. The same link is listed as “Postman Collection” in the APITube docs, so you always land on the current version.

Why do my requests return a 401 error in Postman?#

A 401 means the API did not receive a valid key. If you see ER0201, the api_key variable is empty or unresolved — set it in the collection’s Variables tab or in an active environment. If you see ER0202, the key value is wrong or revoked; copy a fresh key from your dashboard. Confirm the fix by sending the Check balance request.

Do I have to enable each parameter by hand?#

For the Everything request, yes — its many optional filters are included but disabled so the base request stays clean. Tick the checkbox next to any parameter in the query editor to activate it. The requests inside the Examples folder are different: each already has its parameters enabled, so you can send them as-is and then tweak the values.

Can I use the collection without writing code?#

Yes. Postman runs every request for you and shows the live JSON response, so the collection is a full no-code way to explore the News API. If you would rather build requests inside the APITube dashboard, the API Playground offers the same run-with-your-key experience without leaving your account.