Brave Search 🦁

Privacy-focused web search with comprehensive results.

🔍

What you can do: Web search, news search, image search, video search, local business search, and AI-powered answer summarization - all with privacy-first design.

Setup

Add your Brave Search API key in the ProtectMyAPI Dashboard.

Web Search

Basic Search

let brave = ProtectMyAPI.braveSearchService()
 
let results = try await brave.webSearch(
    query: "SwiftUI best practices 2024"
)
 
for result in results.web?.results ?? [] {
    print("Title: \(result.title)")
    print("URL: \(result.url)")
    print("Description: \(result.description ?? "")")
    print("---")
}

val brave = ProtectMyAPIAI.braveSearchService()
 
val results = brave.webSearch(
    query = "Kotlin coroutines best practices 2024"
)
 
results.web?.results?.forEach { result ->
    println("Title: ${result.title}")
    println("URL: ${result.url}")
    println("Description: ${result.description}")
    println("---")
}

final brave = ProtectMyAPIAI.braveSearchService();
 
final results = await brave.webSearch(
  query: "Flutter state management 2024",
);
 
for (final result in results.web?.results ?? []) {
  print("Title: ${result.title}");
  print("URL: ${result.url}");
  print("Description: ${result.description}");
  print("---");
}

With Options

let results = try await brave.webSearch(
    query: "machine learning tutorials",
    options: BraveSearchOptions(
        count: 20,              // Number of results (max 20)
        offset: 0,              // Pagination offset
        country: "US",          // Country code
        searchLang: "en",       // Search language
        uiLang: "en-US",        // UI language
        safesearch: .moderate,  // Safe search filter
        freshness: .pastMonth,  // Time filter
        textDecorations: true,  // Include bold/italic markers
        spellcheck: true        // Auto-correct spelling
    )
)

val results = brave.webSearch(
    query = "machine learning tutorials",
    options = BraveSearchOptions(
        count = 20,
        offset = 0,
        country = "US",
        searchLang = "en",
        uiLang = "en-US",
        safesearch = SafeSearch.MODERATE,
        freshness = Freshness.PAST_MONTH,
        textDecorations = true,
        spellcheck = true
    )
)

final results = await brave.webSearch(
  query: "machine learning tutorials",
  options: BraveSearchOptions(
    count: 20,
    offset: 0,
    country: "US",
    searchLang: "en",
    uiLang: "en-US",
    safesearch: SafeSearch.moderate,
    freshness: Freshness.pastMonth,
    textDecorations: true,
    spellcheck: true,
  ),
);

News Search

Get current news articles:

let news = try await brave.newsSearch(
    query: "artificial intelligence",
    options: BraveSearchOptions(
        count: 10,
        freshness: .pastDay
    )
)
 
for article in news.results ?? [] {
    print("📰 \(article.title)")
    print("Source: \(article.source ?? "Unknown")")
    print("Age: \(article.age ?? "")")
    print("URL: \(article.url)")
}

val news = brave.newsSearch(
    query = "artificial intelligence",
    options = BraveSearchOptions(
        count = 10,
        freshness = Freshness.PAST_DAY
    )
)
 
news.results?.forEach { article ->
    println("📰 ${article.title}")
    println("Source: ${article.source}")
    println("Age: ${article.age}")
    println("URL: ${article.url}")
}

final news = await brave.newsSearch(
  query: "artificial intelligence",
  options: BraveSearchOptions(
    count: 10,
    freshness: Freshness.pastDay,
  ),
);
 
for (final article in news.results ?? []) {
  print("📰 ${article.title}");
  print("Source: ${article.source}");
  print("Age: ${article.age}");
  print("URL: ${article.url}");
}

Image Search

let images = try await brave.imageSearch(
    query: "cute cats",
    options: BraveImageSearchOptions(
        count: 20,
        safesearch: .strict,
        size: .large,         // small, medium, large, wallpaper
        imageType: .photo,    // photo, clipart, gif, transparent
        license: .any         // any, share, shareCommercially
    )
)
 
for image in images.results ?? [] {
    print("Image: \(image.title)")
    print("URL: \(image.url)")
    print("Thumbnail: \(image.thumbnail?.src ?? "")")
    print("Size: \(image.properties?.width ?? 0)x\(image.properties?.height ?? 0)")
}

val images = brave.imageSearch(
    query = "cute cats",
    options = BraveImageSearchOptions(
        count = 20,
        safesearch = SafeSearch.STRICT,
        size = ImageSize.LARGE,
        imageType = ImageType.PHOTO,
        license = ImageLicense.ANY
    )
)
 
images.results?.forEach { image ->
    println("Image: ${image.title}")
    println("URL: ${image.url}")
    println("Thumbnail: ${image.thumbnail?.src}")
    println("Size: ${image.properties?.width}x${image.properties?.height}")
}

final images = await brave.imageSearch(
  query: "cute cats",
  options: BraveImageSearchOptions(
    count: 20,
    safesearch: SafeSearch.strict,
    size: ImageSize.large,
    imageType: ImageType.photo,
    license: ImageLicense.any,
  ),
);
 
for (final image in images.results ?? []) {
  print("Image: ${image.title}");
  print("URL: ${image.url}");
  print("Thumbnail: ${image.thumbnail?.src}");
  print("Size: ${image.properties?.width}x${image.properties?.height}");
}

Video Search

let videos = try await brave.videoSearch(
    query: "Swift programming tutorial",
    options: BraveVideoSearchOptions(
        count: 10,
        freshness: .pastMonth,
        duration: .medium,    // short (<5min), medium (5-20min), long (>20min)
        resolution: .high     // low, medium, high
    )
)
 
for video in videos.results ?? [] {
    print("🎬 \(video.title)")
    print("Source: \(video.source ?? "Unknown")")
    print("Duration: \(video.duration ?? "")")
    print("Views: \(video.views ?? 0)")
    print("URL: \(video.url)")
}

val videos = brave.videoSearch(
    query = "Kotlin programming tutorial",
    options = BraveVideoSearchOptions(
        count = 10,
        freshness = Freshness.PAST_MONTH,
        duration = VideoDuration.MEDIUM,
        resolution = VideoResolution.HIGH
    )
)
 
videos.results?.forEach { video ->
    println("🎬 ${video.title}")
    println("Source: ${video.source}")
    println("Duration: ${video.duration}")
    println("Views: ${video.views}")
    println("URL: ${video.url}")
}

final videos = await brave.videoSearch(
  query: "Flutter programming tutorial",
  options: BraveVideoSearchOptions(
    count: 10,
    freshness: Freshness.pastMonth,
    duration: VideoDuration.medium,
    resolution: VideoResolution.high,
  ),
);
 
for (final video in videos.results ?? []) {
  print("🎬 ${video.title}");
  print("Source: ${video.source}");
  print("Duration: ${video.duration}");
  print("Views: ${video.views}");
  print("URL: ${video.url}");
}

Local Business Search

Find local businesses and places:

let places = try await brave.localSearch(
    query: "coffee shops near me",
    location: BraveLocation(
        latitude: 37.7749,
        longitude: -122.4194,
        radius: 5000 // meters
    )
)
 
for place in places.results ?? [] {
    print("📍 \(place.title)")
    print("Address: \(place.address ?? "N/A")")
    print("Rating: \(place.rating?.value ?? 0)/5 (\(place.rating?.count ?? 0) reviews)")
    print("Phone: \(place.phone ?? "N/A")")
    print("Hours: \(place.openingHours?.current ?? "Unknown")")
    if place.isOpen == true {
        print("✅ Currently Open")
    }
}

val places = brave.localSearch(
    query = "coffee shops near me",
    location = BraveLocation(
        latitude = 37.7749,
        longitude = -122.4194,
        radius = 5000
    )
)
 
places.results?.forEach { place ->
    println("📍 ${place.title}")
    println("Address: ${place.address}")
    println("Rating: ${place.rating?.value}/5 (${place.rating?.count} reviews)")
    println("Phone: ${place.phone}")
    println("Hours: ${place.openingHours?.current}")
    if (place.isOpen == true) {
        println("✅ Currently Open")
    }
}

final places = await brave.localSearch(
  query: "coffee shops near me",
  location: BraveLocation(
    latitude: 37.7749,
    longitude: -122.4194,
    radius: 5000,
  ),
);
 
for (final place in places.results ?? []) {
  print("📍 ${place.title}");
  print("Address: ${place.address}");
  print("Rating: ${place.rating?.value}/5 (${place.rating?.count} reviews)");
  print("Phone: ${place.phone}");
  print("Hours: ${place.openingHours?.current}");
  if (place.isOpen == true) {
    print("✅ Currently Open");
  }
}

AI Summarization

Get AI-generated summaries of search results:

let results = try await brave.webSearch(
    query: "What is quantum computing",
    options: BraveSearchOptions(
        summary: true // Enable AI summary
    )
)
 
// Get the AI-generated summary
if let summary = results.summarizer?.summary {
    print("Summary: \(summary)")
}
 
// Also get the source results
for result in results.web?.results ?? [] {
    print("- \(result.title): \(result.url)")
}

val results = brave.webSearch(
    query = "What is quantum computing",
    options = BraveSearchOptions(
        summary = true
    )
)
 
results.summarizer?.summary?.let { summary ->
    println("Summary: $summary")
}
 
results.web?.results?.forEach { result ->
    println("- ${result.title}: ${result.url}")
}

final results = await brave.webSearch(
  query: "What is quantum computing",
  options: BraveSearchOptions(
    summary: true,
  ),
);
 
if (results.summarizer?.summary != null) {
  print("Summary: ${results.summarizer!.summary}");
}
 
for (final result in results.web?.results ?? []) {
  print("- ${result.title}: ${result.url}");
}

Suggest / Autocomplete

let suggestions = try await brave.suggest(query: "how to learn")
 
for suggestion in suggestions.results ?? [] {
    print("💡 \(suggestion.query)")
}

val suggestions = brave.suggest(query = "how to learn")
 
suggestions.results?.forEach { suggestion ->
    println("💡 ${suggestion.query}")
}

final suggestions = await brave.suggest(query: "how to learn");
 
for (final suggestion in suggestions.results ?? []) {
  print("💡 ${suggestion.query}");
}

Search Options

Freshness Filters

Value	Description
`.pastDay`	Last 24 hours
`.pastWeek`	Last 7 days
`.pastMonth`	Last 30 days
`.pastYear`	Last 365 days

Safe Search

Value	Description
`.off`	No filtering
`.moderate`	Filter explicit content
`.strict`	Strict filtering

Image Sizes

Value	Description
`.small`	Small images
`.medium`	Medium images
`.large`	Large images
`.wallpaper`	Very large/wallpaper

Image Types

Value	Description
`.photo`	Photographs
`.clipart`	Clip art
`.gif`	Animated GIFs
`.transparent`	Transparent background

Video Duration

Value	Description
`.short`	Less than 5 minutes
`.medium`	5-20 minutes
`.long`	Over 20 minutes

Response Structure

Web Search Response

struct BraveWebResponse {
    let query: BraveQuery           // Original query info
    let web: BraveWebResults?       // Web results
    let news: BraveNewsResults?     // Related news
    let videos: BraveVideoResults?  // Related videos
    let summarizer: BraveSummary?   // AI summary (if enabled)
    let infobox: BraveInfobox?      // Knowledge panel
    let discussions: [BraveDiscussion]? // Forum discussions
}

Web Result

struct BraveWebResult {
    let title: String
    let url: String
    let description: String?
    let age: String?                // "2 hours ago", "3 days ago"
    let language: String?
    let familyFriendly: Bool?
    let thumbnail: BraveThumbnail?
    let extraSnippets: [String]?    // Additional text excerpts
}

Pricing

Brave Search API offers:

Free tier: 2,000 queries/month
Basic: $5/1,000 queries
Pro: Volume discounts available

Check their API pricing for current rates.

OpenRouter DeepL