Skip to main content
GET
/
search
Search API
curl --request GET \
  --url https://api.example.com/search
{
  "status": "<string>",
  "data": {
    "query": "<string>",
    "pages_fetched": 123,
    "time_used": 123,
    "pages": {
      "total_results": "<string>",
      "search_results": [
        {
          "title": "<string>",
          "link": "<string>",
          "date": {},
          "snippet": "<string>",
          "source": "<string>"
        }
      ],
      "related_queries": [
        {}
      ],
      "page_content": {
        "enhanced_html": "<string>",
        "page_markdown": "<string>"
      }
    },
    "credits": 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/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. Each page costs 10 credits.

​
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/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/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/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: 
{
  "status": "success",
  "data": {
    "query": "Now in Android",
    "pages_fetched": 1,
    "time_used": 1.2119622230529785,
    "pages": {
      "1": {
        "total_results": "About 41,100 results",
        "search_results": [
          {
            "title": "GitHub - android/nowinandroid: A fully functional Android app built ...",
            "link": "https://github.com/android/nowinandroid",
            "date": null,
            "snippet": "Learn how this app was designed and built in the design case study, architecture learning journey and modularization learning journey.",
            "source": "Github"
          },
          {
            "title": "Now in Android | Android Developers",
            "link": "https://developer.android.com/series/now-in-android",
            "date": "Aug 8, 2025",
            "snippet": "Learn about the latest features and best practices of Android development with Now in Android app and podcast.",
            "source": "Android Developers"
          }
        ],
        "related_queries": [
          "latest Android now",
          "Android now gg",
          "what's new in Android development"
        ],
        "page_content": {
          "enhanced_html": "<body>...</body>",
          "page_markdown": "# Search Results\n..."
        }
      }
    },
    "credits": 10
  }
}
​
status
string
Status of the response (success or error).
​
data
object
Main data object containing search results and metadata.

​
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.
in docs/api-reference/endpoint/search.mdx the response isn’t correct . fix it . the real output example:
Last modified on February 27, 2026