Interactive Query Builder

Use our interactive query builder to create the perfect API query for your needs. This tool helps you build complex queries with all available parameters and generates the corresponding URL and cURL command.

EndpointAPI Key stored locally

🔗 Ready to Integrate?

Get your generated query working in your favorite programming language with our comprehensive integration guides.

https://api.apitube.io/v1/news/everything?sort.order=desc&api_key=YOUR_API_KEY

Quick Start Examples

Example 1: Technology News with Positive Sentiment

Fill in these fields in the query builder:

Title: AI, technology, innovation
Language Code: en
Sentiment Polarity: positive
Source Country Code: us
Sort By: published_at

Example 2: Financial News Analysis

Category ID: medtop:04000000 (Finance)
Organization Name: Apple, Google, Microsoft
Sentiment Score Min: 0.5
Source Rank Min: 0.7
Published At Start: Select last month

Example 3: Breaking News Monitoring

Is Breaking: ✓ (checked)
Language Code: en, fr, de
Per Page: 50
Sort By: published_at
Sort Order: desc

Parameter Categories

The query builder organizes parameters into logical sections:

Section	Parameters	Use Cases
🔗 Endpoint	API endpoint selection	Choose data source
📰 Title	Title filtering and patterns	Content targeting
🌍 Language	Language codes and exclusions	Multi-language content
📂 Categories	IPTC category taxonomy	Topic classification
🏷️ Topics	Custom topic identifiers	Specific subject areas
🏭 Industries	Industry classification	Business sector analysis
🎯 Entities	Named entity recognition	Person/place/organization
👤 Persons	People mentioned in articles	Celebrity/public figure tracking
📍 Locations	Geographic targeting	Regional news analysis
🏢 Organizations	Company/institution filtering	Corporate news monitoring
🏷️ Brands	Brand mention tracking	Marketing intelligence
✍️ Authors	Journalist/writer filtering	Author-based curation
😊 Sentiment	Emotion and opinion analysis	Sentiment monitoring
🖼️ Media	Image/video requirements	Rich media content
📡 Source	Publisher filtering and ranking	Source credibility
📅 Date Range	Time-based filtering	Historical/recent analysis
🔄 Sorting	Result ordering	Data presentation
📄 Pagination	Result chunking	Large dataset handling
🔧 Other Filters	Advanced options	Content quality control
📤 Export	Output format selection	Data integration

API Key Management

Security Note

Never share your API key publicly. The query builder stores your key locally in your browser session only.

To test queries directly:

Enter your API key in the 🔑 API Key section
Configure your query parameters
Click 🧪 Test Query to open results in a new tab

Advanced Usage Tips

1. Multiple Values

Most parameters support multiple values separated by commas:

title=Bitcoin,Ethereum,Cryptocurrency
source.domain=theverge.com
language.code=en,fr,de

2. Exact Phrase Matching

Use quotes for exact phrases:

title="Breaking News"
organization.name="Apple Inc"

3. Regex Patterns

Use the title pattern field for complex matching:

title_pattern=^Breaking.*|.*Update$

4. Date Formats

The date fields support multiple formats:

2024-01-15 (YYYY-MM-DD)
2024-01-15T10:30:00Z (ISO format)
15-01-2024 (DD-MM-YYYY)

5. Combining Filters

Combine multiple filter types for precise targeting:

Technology news + Positive sentiment + High-ranked sources
Financial articles + Specific companies + Last 7 days
Breaking news + Multiple languages + Video content

Integration Examples

JavaScript/Node.js

javascript

// Copy the generated URL from the query builder
const apiUrl = 'https://api.apitube.io/v1/news/everything?title=AI&sentiment.overall.polarity=positive&api_key=YOUR_KEY';

fetch(apiUrl)
  .then(response => response.json())
  .then(data => console.log(data));

Python

python

import requests

# Copy the generated URL from the query builder
url = "https://api.apitube.io/v1/news/everything"
params = {
    "title": "AI",
    "sentiment.overall.polarity": "positive",
    "api_key": "YOUR_KEY"
}

response = requests.get(url, params=params)
data = response.json()

cURL

Simply copy the generated cURL command from the query builder and run it in your terminal.

Need Help?

📖 Check the Parameters Reference for detailed parameter documentation
🔧 Visit Common Workflows for more examples
🐛 Report issues or request features through our support channels

The query builder is constantly updated to reflect the latest API capabilities. Bookmark this page for easy access to the most current version.

Suggest

Reference

AI

Interactive Query Builder ​

📰 Title Parameters

🌍 Language

📂 Categories

🏷️ Topics

🏭 Industries

🎯 Entities

👤 Persons

📍 Locations

🏢 Organizations

🏷️ Brands

✍️ Authors

🌪️ Disasters

🦠 Diseases

🎫 Events

😊 Sentiment

🖼️ Media

📡 Source

📅 Date Range

🔄 Sorting

📄 Pagination

🔧 Other Filters

📖 Readability

📄 Single Article

📈 Trends

🎯 Field Selection

📊 Faceting

🔆 Highlighting

✨ Enrichment

📤 Export Format

🔗 Ready to Integrate?

📱 Mobile & Desktop

🌐 Web Development

💻 Backend & Enterprise

🔧 Tools & Scripts

Quick Start Examples ​

Example 1: Technology News with Positive Sentiment ​

Example 2: Financial News Analysis ​

Example 3: Breaking News Monitoring ​

Parameter Categories ​

API Key Management ​

Advanced Usage Tips ​

1. Multiple Values ​

2. Exact Phrase Matching ​

3. Regex Patterns ​

4. Date Formats ​

5. Combining Filters ​

Integration Examples ​

JavaScript/Node.js ​

Python ​

cURL ​

Need Help? ​