browseto.com Public API Guide

Introduction

The browseto.com Public API allows you to leverage our intelligent search and navigation capabilities within your own websites, applications, or scripts. Simply send a search query, and our API will return a list of relevant URLs, just like using browseto.com directly.

This API is designed to be simple and easy to use, with open access (no API key required for now). It supports direct navigation for specific URLs and AI-powered search for broader queries.

Getting Started

Request Format

The request body must be a JSON object with the following fields:

• prompt (string, required): The search query or command (e.g., "latest AI news", "gmail.com").
• model (string, optional): Specify the AI model to use. Defaults to Gemini 2.5 Flash. Available models include:
  • gemini-2.5-flash-preview-04-17 (Gemini 2.5 Flash)
  • gemini-2.5-pro-preview-05-06 (Gemini 2.5 Pro (Preview))
  • gemini-2.5-pro-exp-03-25 (Gemini 2.5 Pro (Experimental))
  • ...and more (refer to our model list if available, or experiment).

Example Request Body:

{
  "prompt": "your search query here", // Required
  "model": "gemini-2.5-flash-preview-04-17" // Optional
}

Response Format

Success Response (200 OK):

On success, the API returns a JSON object with:

• urls: An array of strings, where each string is a resulting URL.
• type: A string indicating the type of result, either "ai_search" or "direct_navigation".

{
  "urls": [
    "https://www.example.com/result1",
    "https://www.anotherdomain.net/page"
  ],
  "type": "ai_search" // or "direct_navigation"
}

Error Response (4xx or 5xx):

If an error occurs, the API returns a JSON object with an error field containing a message. Additional fields like details or unsafeUrls may be present.

{
  "error": "Invalid or empty 'prompt' provided."
}
// Another error example for unsafe URL
{
  "error": "The provided URL appears to be unsafe.",
  "details": {
    "url": "http://unsafe-example.com",
    "reason": "URL marked as unsafe",
    "threatType": "MALWARE"
  }
}

Usage Examples

curl -X POST https://www.browseto.com/api/public-search \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "latest AI news"
  }'

async function searchBrowseto(query) {
  try {
    const response = await fetch('https://www.browseto.com/api/public-search', {
      method: 'POST',
      headers: {
        'Content-Type: application/json',
      },
      body: JSON.stringify({ prompt: query }),
    });

    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(errorData.error || `API request failed with status ${response.status}`);
    }

    const data = await response.json();
    console.log('Search Results:', data.urls);
    return data.urls;
  } catch (error) {
    console.error('Error calling browseto API:', error);
    return [];
  }
}

// Example usage:
searchBrowseto('best coffee shops in San Francisco').then(urls => {
  if (urls.length > 0) {
    // Navigate to the first URL or display them
    // window.location.href = urls[0]; 
  }
});