APITube Documentation
Sign inGet started

Zapier Integration ​

Use Zapier to connect the News API to other apps. These examples show how to monitor news, send alerts and create summaries.

Prerequisites ​

  • Zapier account (free or paid plan)
  • APITube API key (get one from your dashboard)

Setting Up APITube Credentials ​

Use Webhooks by Zapier to call the API. Send your API key in a request header.

When configuring a Webhooks step:

  1. Set Method to GET
  2. Under Headers, add: X-API-Key | YOUR_API_KEY
  3. Set URL to the APITube endpoint (e.g., https://api.apitube.io/v1/news/everything)
TIP

You can also pass the API key as a query parameter: add api_key=YOUR_API_KEY to the URL. However, using the header is recommended for security.

API Endpoints Reference ​

EndpointMethodDescription
/v1/news/everythingGETSearch all articles with 50+ filters
/v1/news/top-headlinesGETHeadlines from highly ranked sources
/v1/news/articleGETGet articles by ID
/v1/news/story/:articleIdGETGet related articles for a story
/v1/news/trendsGETTrending subjects and article counts

Base URL: https://api.apitube.io

Full list of endpoints and parameters: Endpoints | Parameters

Zap 1: News Monitoring → Google Sheets ​

Automatically collect news articles matching your criteria into a Google Sheets spreadsheet.

How it works:

  • Schedule by Zapier triggers every 15 minutes
  • Webhooks by Zapier sends a GET request to APITube
  • Looping by Zapier processes each article
  • Google Sheets appends each article as a row

Step-by-step setup:

Step 1: Schedule by Zapier (Trigger) ​

  • Choose Schedule by Zapier as trigger
  • Set Schedule to Every 15 Minutes

Step 2: Webhooks by Zapier (GET Request) ​

  • Choose Webhooks by Zapier → Custom Request
  • Method: GET
  • URL: https://api.apitube.io/v1/news/everything?title=artificial+intelligence&language.code=en&per_page=50&sort.by=published_at&sort.order=desc
  • Headers: X-API-Key | YOUR_API_KEY

Step 3: Looping by Zapier ​

  • Choose Looping by Zapier → Create Loop From Line Items
  • Set Values to Loop to the results array from Step 2

Step 4: Google Sheets (Create Row) ​

  • Choose Google Sheets → Create Spreadsheet Row
  • Map fields:
    • Title → article title
    • URL → article url
    • Source → article source name
    • Published → article published_at
    • Sentiment → article sentiment overall polarity

Customization tips:

  • Change the title query parameter to monitor different keywords
  • Add category.id to filter by category (see list of categories)
  • Add source.country.code to filter by country (e.g., us, gb)
  • Use person.name or organization.name to follow news about specific people or companies

Zap 2: News Alerts → Slack / Email ​

Get notified in Slack or email when new articles match your criteria.

How it works:

  • Schedule by Zapier triggers every 30 minutes
  • Webhooks by Zapier fetches articles from APITube
  • Filter by Zapier checks if there are results
  • Slack / Gmail sends a formatted notification

Step-by-step setup:

Step 1: Schedule by Zapier (Trigger) ​

  • Set Schedule to Every 30 Minutes

Step 2: Webhooks by Zapier (GET Request) ​

  • Method: GET
  • URL: https://api.apitube.io/v1/news/everything?title=startup+funding&language.code=en&per_page=10&sort.by=published_at&sort.order=desc
  • Headers: X-API-Key | YOUR_API_KEY

Step 3: Filter by Zapier ​

  • Field: results count from Step 2
  • Condition: Greater than 0
  • This prevents empty notifications when no articles are found

Step 4: Slack — Send Channel Message ​

  • Channel: your target channel
  • Message Text:
text
New articles found for "startup funding":

[Article Title] — mapped from results → title
[Source Name] • [Published Date] — mapped from results → source.domain, published_at
[Article URL] — mapped from results → href

Use Zapier's field mapper to insert article fields from the Webhooks step.

For Email: Replace Slack with Gmail → Send Email:

  • Subject: News Alert: startup funding
  • Body: map article fields (title, url, source, published_at)

Zap 3: AI News Digest → Email ​

Use ChatGPT to summarise each day's news and email the summary.

How it works:

  • Schedule by Zapier triggers once daily (e.g., 8:00 AM)
  • Webhooks by Zapier fetches top headlines
  • Code by Zapier formats articles into a text list
  • ChatGPT by Zapier summarizes the articles
  • Gmail sends the digest

Step-by-step setup:

Step 1: Schedule by Zapier (Trigger) ​

  • Set Schedule to Every Day at 8:00 AM

Step 2: Webhooks by Zapier (GET Request) ​

  • Method: GET
  • URL: https://api.apitube.io/v1/news/top-headlines?language.code=en&per_page=20&sort.by=published_at&sort.order=desc
  • Headers: X-API-Key | YOUR_API_KEY

Step 3: Code by Zapier (Format Articles) ​

  • Language: JavaScript
  • Input Data: articles → results array from Step 2
  • Code:
javascript
const articles = JSON.parse(inputData.articles);
const formatted = articles.map((a, i) =>
  `${i + 1}. ${a.title} (${a.source.domain})\n   ${a.href}`
).join('\n\n');

output = [{ summary: formatted, count: articles.length }];

Step 4: ChatGPT — Conversation ​

  • User Message: Summarize the following ${count} news articles into a concise daily digest. Group by topic, highlight the most important stories, and keep it under 500 words.\n\n${summary}

Step 5: Gmail — Send Email ​

  • To: your email address
  • Subject: Daily News Digest
  • Body: ChatGPT response from Step 4

Parameters ​

See Parameters for 50+ filters, including language, category, sentiment, entities and date ranges.

Tips & Tricks ​

  • URL encoding: Spaces in query parameters should be encoded as + or %20 (e.g., title=climate+change)
  • Rate limits: APITube allows 50 requests per minute. Space your Schedule triggers accordingly
  • Pagination: Use page parameter to fetch more results. Max per_page is 250 (10 on Free, 50 on Starter, 200 on Basic)
  • Date filtering: Use published_at.start with a relative date to avoid duplicate articles between polls
  • Zapier plan limits: The free plan allows 100 tasks per month. Choose how often your Zap runs to stay within your limit
  • Error handling: Add a Paths by Zapier step after the Webhooks step to handle HTTP errors

Next Steps ​