Skip to content

🔍 Rich Suggestions - Intelligent Search with Wikipedia

Advanced search suggestions service combining Wikipedia results with intelligent query analysis and rich metadata.

Rich Suggestions provides comprehensive search results by integrating multiple data sources and applying advanced query intelligence to deliver rich, contextual information.

🌟 Features

Rich Suggestions offers 10+ advanced capabilities:

  • ✅ Wikipedia Integration - Real-time Wikipedia article search and suggestions
  • ✅ Rich Article Metadata - Extracts, thumbnails, categories, and more
  • ✅ Intelligent Query Suggestions - Smart related search generation
  • ✅ Category Extraction - Automatic topic categorization
  • ✅ Trending Topics - Detection of trending and popular searches
  • ✅ Query Complexity Analysis - Analyzes search intent and complexity
  • ✅ Multi-Source Results - Combines Wikipedia with proprietary algorithms
  • ✅ Article Summaries - Concise extracts from Wikipedia articles
  • ✅ Related Searches - Context-aware search suggestions
  • ✅ Confidence Scoring - Result quality and relevance metrics

🚀 Getting Started

Endpoint

https://apis.novasuite.one/web/rich-suggestions

Single Query (GET)

curl "https://apis.novasuite.one/web/rich-suggestions?q=artificial+intelligence"

Single Query (POST)

curl -X POST https://apis.novasuite.one/web/rich-suggestions \
  -H "Content-Type: application/json" \
  -d '{"q": "artificial intelligence"}'

Batch Queries (POST)

curl -X POST https://apis.novasuite.one/web/rich-suggestions \
  -H "Content-Type: application/json" \
  -d '{
    "queries": [
      "machine learning",
      "quantum computing",
      "climate change"
    ]
  }'

📊 Response Format

Single Query Response

{
  "service": "NovaAPIs Rich Suggestions",
  "timestamp": "2025-11-22T12:00:00.000Z",
  "count": 1,
  "results": {
    "query": "artificial intelligence",
    "suggestions": {
      "wikipedia": [
        {
          "title": "Artificial intelligence",
          "description": "Intelligence demonstrated by machines...",
          "url": "https://en.wikipedia.org/wiki/Artificial_intelligence",
          "source": "wikipedia"
        }
      ],
      "related": [
        "artificial intelligence tutorial",
        "artificial intelligence examples",
        "artificial intelligence explained",
        "artificial intelligence guide",
        "best artificial intelligence"
      ],
      "trending": [
        {
          "topic": "machine learning",
          "category": "technology",
          "trending": true
        }
      ]
    },
    "article": {
      "title": "Artificial intelligence",
      "extract": "Artificial intelligence (AI) is intelligence demonstrated by machines...",
      "thumbnail": "https://upload.wikimedia.org/...",
      "categories": ["Computer science", "Artificial intelligence", "Technology"],
      "url": "https://en.wikipedia.org/wiki/Artificial_intelligence"
    },
    "metadata": {
      "query": "artificial intelligence",
      "timestamp": "2025-11-22T12:00:00.000Z",
      "hasWikipediaResults": true,
      "resultCount": 5,
      "topics": ["Computer science", "Technology"],
      "categories": ["Computer science", "Artificial intelligence"],
      "confidence": 0.9,
      "queryComplexity": "moderate"
    },
    "querySuggestions": {
      "original": "artificial intelligence",
      "type": "general",
      "relatedSearches": [
        "artificial intelligence tutorial",
        "artificial intelligence examples",
        "artificial intelligence explained"
      ]
    }
  }
}

Batch Query Response

{
  "service": "NovaAPIs Rich Suggestions",
  "timestamp": "2025-11-22T12:00:00.000Z",
  "count": 3,
  "results": [
    {
      "query": "machine learning",
      "suggestions": { /* ... */ },
      "article": { /* ... */ },
      "metadata": { /* ... */ }
    },
    {
      "query": "quantum computing",
      "suggestions": { /* ... */ },
      "article": { /* ... */ },
      "metadata": { /* ... */ }
    },
    {
      "query": "climate change",
      "suggestions": { /* ... */ },
      "article": { /* ... */ },
      "metadata": { /* ... */ }
    }
  ]
}

🎯 Use Cases

  • Search Engines - Enhance search with rich Wikipedia data
  • Educational Apps - Provide comprehensive topic information
  • Content Discovery - Help users explore related topics
  • Research Tools - Quick access to authoritative information
  • Chatbots - Enrich responses with factual data
  • Knowledge Bases - Auto-populate with Wikipedia content
  • Learning Platforms - Contextual information for topics
  • News Apps - Background information on current events

📚 Code Examples

JavaScript/Node.js

async function searchQuery(query) {
  const response = await fetch(
    `https://apis.novasuite.one/web/rich-suggestions?q=${encodeURIComponent(query)}`
  );
  const data = await response.json();

  console.log('Query:', data.results.query);
  console.log('Wikipedia Results:', data.results.suggestions.wikipedia);
  console.log('Article:', data.results.article);
  console.log('Confidence:', data.results.metadata.confidence);

  return data.results;
}

// Usage
searchQuery('quantum physics');

async function batchSearch(queries) {
  const response = await fetch(
    'https://apis.novasuite.one/web/rich-suggestions',
    {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ queries })
    }
  );
  const data = await response.json();

  data.results.forEach(result => {
    console.log(`${result.query}: ${result.article?.title || 'No article found'}`);
  });

  return data.results;
}

// Usage
batchSearch(['AI', 'ML', 'Blockchain']);

Python

import requests

def search_query(query):
    response = requests.get(
        'https://apis.novasuite.one/web/rich-suggestions',
        params={'q': query}
    )
    data = response.json()

    print(f"Query: {data['results']['query']}")
    print(f"Wikipedia Results: {data['results']['suggestions']['wikipedia']}")
    print(f"Confidence: {data['results']['metadata']['confidence']}")

    return data['results']

# Usage
search_query('machine learning')

Batch Search (Python)

import requests

def batch_search(queries):
    response = requests.post(
        'https://apis.novasuite.one/web/rich-suggestions',
        json={'queries': queries}
    )
    data = response.json()

    for result in data['results']:
        print(f"{result['query']}: {result.get('article', {}).get('title', 'No article')}")

    return data['results']

# Usage
batch_search(['AI', 'ML', 'Blockchain'])

cURL

# Single query
curl "https://apis.novasuite.one/web/rich-suggestions?q=climate+change" \
  | jq '.results.article.title'

# Batch queries
curl -X POST https://apis.novasuite.one/web/rich-suggestions \
  -H "Content-Type: application/json" \
  -d '{"queries": ["AI", "ML", "Blockchain"]}' \
  | jq '.results[] | {query, confidence: .metadata.confidence}'

📖 API Reference

GET /web/rich-suggestions

Query Parameters:

  • q (optional) - Search query

Response: Service information (if no query) or search results

POST /web/rich-suggestions

Body:

{
  "q": "string",           // Single query
  "query": "string",       // Alternative to "q"
  "queries": ["string"]    // Or array of queries (max 10)
}

Response: Search results for query/queries

📊 Response Fields

Suggestions Object

Field Type Description
wikipedia array Wikipedia article results
related array Related search suggestions
trending array Trending topics related to query

Article Object

Field Type Description
title string Article title
extract string Article summary/extract
thumbnail string Article thumbnail image URL
categories array Wikipedia categories
url string Full Wikipedia article URL

Metadata Object

Field Type Description
query string Original search query
timestamp string Response timestamp
hasWikipediaResults boolean Whether Wikipedia results found
resultCount number Number of suggestions
topics array Extracted topics
categories array Article categories
confidence number Result confidence (0-1)
queryComplexity string Query complexity level

🔒 Privacy & Data

  • No data storage - Queries are processed in real-time
  • No tracking - We don't track users or queries
  • Wikipedia attribution - Results properly attributed to Wikipedia
  • CORS enabled - Use from any domain

⚡ Rate Limits

Free Tier: 50 requests per hour per IP

Rate limit information is included in response headers:

  • X-RateLimit-Limit - Maximum requests allowed
  • X-RateLimit-Remaining - Requests remaining in current window
  • X-RateLimit-Reset - Unix timestamp when limit resets

💡 Tips & Best Practices

  1. Use batch queries for multiple searches to reduce API calls
  2. Check confidence scores to determine result quality
  3. Cache results for frequently searched queries
  4. Handle missing articles gracefully (not all queries have Wikipedia articles)
  5. Use related searches to improve user experience

🐛 Support

For questions or support inquiries, please contact us at api@novasuite.one.