Loading...
Loading...
Use this skill when the user wants to search the web without a full browser session: find URLs, titles, and metadata for a query. Prefer it over a browser when you just need search results, not page content. Returns structured results with titles, URLs, authors, and dates.
npx skill4agent add browserbase/skills searchexport BROWSERBASE_API_KEY="your_api_key"| Use Case | Search API | Browser Skill |
|---|---|---|
| Find URLs for a topic | Yes | Overkill |
| Get page titles and metadata | Yes | Overkill |
| Read full page content | No | Yes |
| JavaScript-rendered pages | No | Yes |
| Form interactions | No | Yes |
| Speed | Fast | Slower |
curl -X POST "https://api.browserbase.com/v1/search" \
-H "Content-Type: application/json" \
-H "X-BB-API-Key: $BROWSERBASE_API_KEY" \
-d '{"query": "browserbase web automation"}'| Field | Type | Default | Description |
|---|---|---|---|
| string | required | The search query |
| integer (1-25) | | Number of results to return |
| Field | Type | Description |
|---|---|---|
| string | Unique identifier for the search request |
| string | The search query that was executed |
| array | List of search result objects |
| Field | Type | Description |
|---|---|---|
| string | Unique identifier for the result |
| string | URL of the result |
| string | Title of the result |
| string? | Author of the content (if available) |
| string? | Publication date (if available) |
| string? | Image URL (if available) |
| string? | Favicon URL (if available) |
Note: Thedoes not have a search method yet. Use cURL or direct HTTP calls.@browserbasehq/sdk
curl -X POST "https://api.browserbase.com/v1/search" \
-H "Content-Type: application/json" \
-H "X-BB-API-Key: $BROWSERBASE_API_KEY" \
-d '{"query": "web scraping best practices", "numResults": 5}'| Status | Meaning |
|---|---|
| 400 | Invalid request body (check query and parameters) |
| 403 | Invalid or missing API key |
| 429 | Rate limit exceeded (retry later) |
| 500 | Internal server error (retry later) |
numResults