Skip to main content
GET
/
search
Search API
curl --request GET \
  --url https://api.example.com/search
{
  "results": [
    {
      "title": "<string>",
      "url": "<string>",
      "snippet": "<string>",
      "raw_html": "<string>",
      "ai_enhanced_html": "<string>",
      "text": "<string>",
      "markdown": "<string>"
    }
  ],
  "total_results": 123,
  "page": 123
}

​
Overview

The Search API provides real-time web search with optional automatic crawling of search results. Perfect for AI applications that need fresh web data.

​
Endpoint

GET https://api.crawleo.dev/api/v1/search

​
Parameters

​
Required Parameters

​
query
string
required
The search query string.

​
Pagination Parameters

​
count
integer
default:"10"
Number of results to return per page (1-50).
​
max_pages
integer
default:"1"
Maximum number of search result pages to fetch.

​
Localization Parameters

​
setLang
string
Language code for search results (e.g., en, es, fr, de).
​
cc
string
Country code for search results (e.g., US, GB, DE).
​
geolocation
string
Geographic location for localized results.

​
Device Simulation

​
device
string
default:"desktop"
Device type to simulate. Options: desktop, mobile, tablet.

​
Output Format Parameters

​
get_raw_html
boolean
default:"false"
Return the original HTML source of each result page.
​
get_ai_enhanced_html
boolean
default:"false"
Return clean HTML with ads, scripts, and tracking removed.
​
get_page_text
boolean
default:"false"
Return plain text content extracted from each result page.
​
get_page_text_markdown
boolean
default:"false"
Return content as structured Markdown (recommended for RAG/LLM).

​
Auto-Crawling

​
auto_crawling
boolean
default:"false"
Automatically crawl each search result URL and include page content.

​
Example Requests

curl -X GET "https://api.crawleo.dev/api/v1/search?query=machine%20learning&count=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Search with Auto-Crawling and Markdown Output

curl -X GET "https://api.crawleo.dev/api/v1/search?query=python%20tutorials&count=5&auto_crawling=true&get_page_text_markdown=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X GET "https://api.crawleo.dev/api/v1/search?query=news&setLang=de&cc=DE&count=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

A successful response returns search results with optional crawled content: 
{
  "results": [
    {
      "title": "Introduction to Machine Learning",
      "url": "https://example.com/ml-intro",
      "snippet": "A comprehensive guide to machine learning...",
      "markdown": "# Introduction to Machine Learning\n\nMachine learning is..."
    }
  ],
  "total_results": 1000,
  "page": 1
}
​
results
array
Array of search result objects.
​
total_results
integer
Estimated total number of results available.
​
page
integer
Current page number.

​
Use Cases

Use auto_crawling=true with get_page_text_markdown=true to fetch search results and their full content in a single request, formatted for LLM consumption.
Combine with localization parameters to gather region-specific information for AI research agents.
Use get_ai_enhanced_html=true to collect clean content from multiple sources without ads and scripts.