< Back
Print

Navigate to Post Campaigns → News API to manage news article campaigns from 80,000+ sources worldwide.

Understanding News API

What It Does:

  • Fetches fresh news articles from major publications
  • Searches by keywords across thousands of sources
  • Automatically posts articles to your subdomains
  • Keeps content current and relevant

API Requirement:

  • Requires News API key from newsapi.org
  • Must be configured in API Settings
  • Free tier available with request limits
  • Paid tiers for higher volume

Content Strategy:

  • Ideal for news-focused subdomains
  • Current events coverage
  • Industry news aggregation
  • Trending topics
  • Breaking news distribution

News API Campaigns Dashboard

Table Columns:

  • Campaign Name
  • News API Source
  • News API Category
  • Country
  • Search Keywords
  • Image Keywords
  • Category (destination subdomain)
  • Status
  • Created Date
  • Edit/Delete buttons

Adding New Campaign: Click “Create New Campaign” button to open creation form.

Creating News API Campaign

Campaign Name

  • Purpose: Internal identifier
  • Best Practice: Include source and topic (e.g., “TechCrunch-AI-News”)

Tag

  • Purpose: Organize campaigns
  • Use Cases: Niche grouping, client organization, content type

News API Source

  • Purpose: Select specific news publication
  • Dropdown: Lists major publications and sources
  • Examples: BBC News, TechCrunch, The Verge, CNN, Reuters
  • Strategy: Choose sources aligned with subdomain niche

News API Category

  • Purpose: Select news category from chosen source
  • Options:
    • Business
    • Entertainment
    • Health
    • Science
    • Sports
    • Technology
    • General
  • Note: Not all sources have all categories

News API Country

  • Purpose: Target specific geographic region
  • Options: Major countries worldwide (US, UK, CA, AU, etc.)
  • Use Case: Localized news for regional subdomains

Search News API

  • Purpose: Keywords to search for within source
  • Example: “artificial intelligence, machine learning, AI technology”
  • Behavior:
    • Searches for articles matching these keywords
    • If no matches found, no posts created in that run
    • Searches again in next scheduled run
  • Strategy: Use broad enough terms to consistently find content

Image Search

  • Purpose: Keywords for finding images
  • Source: Pixabay
  • Example: “technology, computer, robot, circuit board”
  • Best Practice: Use visual, generic terms

Select Category

  • Purpose: Choose destination subdomain/category
  • Dropdown: All available subdomains and categories
  • Selection: Articles post here

Post Status

  • Options: Published, Draft, Pending Review
  • Default: Published for automation

Rewrite using AI

  • Purpose: Rewrite fetched article using AI for uniqueness
  • Requirement: AI must be enabled in Feed Settings
  • Benefit: Creates unique versions of news articles
  • SEO Impact: Avoids duplicate content issues

Select Prompt Set (if Rewrite enabled)

  • Purpose: Choose rewrite prompt configuration
  • Default: “Default Set” available
  • Custom: Create rewrite-specific prompts in AI Settings
  • Impact: Controls rewriting style and depth

Complete by Date (Optional)

  • Purpose: Set campaign end date
  • Options:
    • Select date from calendar
    • Leave blank for indefinite running
  • Use Case: Limited-time news coverage, event-based campaigns

Saving Campaign: Click “Save” button to create and schedule News API campaign.

Importing News API Campaigns in Bulk

Purpose: Create multiple News API campaigns simultaneously via CSV

Access: Click “Import Campaigns” button on dashboard

CSV Template Download:

  1. Click CSV upload section link
  2. Download ZIP file containing:
    • Sample News API Campaign CSV
    • PDF instructions
    • News API Source list (text file)
    • News API Category list (text file)
    • News API Country list (text file)

CSV Column Structure:

Column A: News API Source

  • Purpose: Source publication name
  • Format: One source name per row
  • Critical: Must match exactly with available sources
  • Best Practice: Copy from provided text file to avoid errors

Column B: News API Category

  • Purpose: Content category
  • Options: Business, Entertainment, Health, Science, Sports, Technology, General
  • Critical: Must match exactly (case-sensitive)
  • Best Practice: Copy from provided text file

Column C: News API Country

  • Purpose: Geographic targeting
  • Format: Country name or code
  • Critical: Must match exactly
  • Best Practice: Copy from provided text file

Column D: Category ID

  • Purpose: Destination subdomain identifier
  • Finding ID:
    1. Go to Subdomain Settings → Manage Categories
    2. Find desired subdomain in table
    3. Note ID from first column
    4. Enter in Column D
  • Format: Integer number

Column E: Search News API Keyword

  • Purpose: Search terms for finding articles
  • Format: Keywords for filtering source content
  • Example: “cryptocurrency, bitcoin, blockchain, ethereum”

Column F: Search Image By Keyword

  • Purpose: Determine image keyword source
  • Values:
    • N: Use category name (Column D) as image keyword
    • Y: Use custom keywords from Column G
  • Strategy: N for simplicity, Y for specific control

Column G: Image Keyword

  • Purpose: Custom image search keywords
  • Active When: Column F = Y
  • Format: Multiple keywords allowed
  • Leave Blank: If Column F = N

Column H: Complete Changes By Date

  • Purpose: Campaign end date
  • Format: MM/DD/YYYY
  • Optional: Leave blank for indefinite campaigns

Column I: Prompt Set

  • Purpose: Rewrite prompt set name
  • Default: “Default Set”
  • Custom: Must match exact name from AI Settings
  • Critical: Case-sensitive, must exist in system

Column J: Campaign Name

  • Purpose: Internal campaign identifier
  • Mandatory: Cannot be empty
  • Best Practice: Descriptive and unique

Uploading CSV:

  1. Complete all columns
  2. Save file
  3. Click “Import Campaigns” button
  4. “Choose File” – select your CSV
  5. Click “Upload” button
  6. System validates data
  7. If no errors, campaigns created
  8. If errors, messages show specific issues to fix

Error Resolution:

  • Review error messages
  • Correct CSV file
  • Re-upload
Table of Contents