APITube Documentation

Appearance

Sign inGet started

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.

🔗 Endpoint

📰 Title Parameters

🌍 Language

📂 Categories

🏷️ Topics

🏭 Industries

🎯 Entities

👤 Persons

📍 Locations

🏢 Organizations

🏷️ Brands

✍️ Authors

😊 Sentiment

🖼️ Media

📡 Source

📅 Date Range

🔄 Sorting

📄 Pagination

🔧 Other Filters

📤 Export Format

🔑 API Key

🔗 Ready to Integrate?

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

📱 Mobile & Desktop
SwiftKotlinObjective-C
🌐 Web Development
JavaScriptNode.jsPHP
💻 Backend & Enterprise
PythonJavaGoC#
🔧 Tools & Scripts
cURL/ShellRRubyRust
📚 View All 25+ Integrations

🚀 Generated Query

URL:https://api.apitube.io/v1/news/everything?sort.order=desc&api_key=YOUR_API_KEY
cURL Command:
curl -X GET "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:

SectionParametersUse Cases
🔗 EndpointAPI endpoint selectionChoose data source
📰 TitleTitle filtering and patternsContent targeting
🌍 LanguageLanguage codes and exclusionsMulti-language content
📂 CategoriesIPTC category taxonomyTopic classification
🏷️ TopicsCustom topic identifiersSpecific subject areas
🏭 IndustriesIndustry classificationBusiness sector analysis
🎯 EntitiesNamed entity recognitionPerson/place/organization
👤 PersonsPeople mentioned in articlesCelebrity/public figure tracking
📍 LocationsGeographic targetingRegional news analysis
🏢 OrganizationsCompany/institution filteringCorporate news monitoring
🏷️ BrandsBrand mention trackingMarketing intelligence
✍️ AuthorsJournalist/writer filteringAuthor-based curation
😊 SentimentEmotion and opinion analysisSentiment monitoring
🖼️ MediaImage/video requirementsRich media content
📡 SourcePublisher filtering and rankingSource credibility
📅 Date RangeTime-based filteringHistorical/recent analysis
🔄 SortingResult orderingData presentation
📄 PaginationResult chunkingLarge dataset handling
🔧 Other FiltersAdvanced optionsContent quality control
📤 ExportOutput format selectionData 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:

  1. Enter your API key in the 🔑 API Key section
  2. Configure your query parameters
  3. 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=cnn.com,bbc.com,reuters.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.