Skip to main content
🧪 BETA - This API is in beta - it may change and might not be available at all times.

​
Why Browser Use Over Traditional Search?

Browser Use actually browses websites like a human while other tools return cached data from landing pages. Browser Use navigates deep into sites in real-time:
  • 🔍 Deep navigation: Clicks through menus, forms, and multiple pages to find buried content
  • 🚀 Always current: Live prices, breaking news, real-time analytics - not cached results
  • 🎯 No stale data: See exactly what’s on the page right now
  • 🌐 Dynamic content: Handles JavaScript, forms, and interactive elements
  • 🏠 No surface limitations: Gets data from pages that require navigation or interaction
Other tools see yesterday’s front door. Browser Use explores today’s whole house.

​
Quick Start

The Search API allows you to quickly extract relevant content from websites using AI. There are two main endpoints: 💡 Complete working examples are available in the examples/search folder. Search Google and extract content from multiple top results: 
import aiohttp
import asyncio

async def simple_search():
    payload = {
        "query": "latest AI news",
        "max_websites": 5,
        "depth": 2
    }

    headers = {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    }

    async with aiohttp.ClientSession() as session:
        async with session.post(
            "https://api.browser-use.com/api/v1/simple-search",
            json=payload,
            headers=headers
        ) as response:
            result = await response.json()
            return result

asyncio.run(simple_search())

​
Search URL

Extract content from a specific URL: 
async def search_url():
    payload = {
        "url": "https://browser-use.com/#pricing",
        "query": "Find pricing information for Browser Use",
        "depth": 2
    }

    headers = {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    }

    async with aiohttp.ClientSession() as session:
        async with session.post(
            "https://api.browser-use.com/api/v1/search-url",
            json=payload,
            headers=headers
        ) as response:
            result = await response.json()
            return result

asyncio.run(search_url())

​
Parameters

  • query: Search query or content to extract
  • depth: How deep to navigate within each website (2-5, default: 2)
    • depth=2: Checks main page + 1 click deeper
    • depth=3: Checks main page + 2 clicks deeper
    • depth=5: Thoroughly explores multiple navigation levels
  • max_websites: Number of websites to process (simple-search only, default: 5)
  • url: Target URL to extract from (search-url only)

​
Pricing

​
Simple Search

Cost per request: 1 cent × depth × max_websites Example: depth=2, max_websites=3 = 6 cents per request

​
Search URL

Cost per request: 1 cent × depth Example: depth=2 = 2 cents per request
⌘I