The SERP section helps you quickly choose the right search engine and understand which filters, localization options, and pagination controls are available for each engine.

• If you want to pick an engine first, start with Supported Engines
• If you want to understand the recurring filters first, start with Common Parameters
• If you already know the engine you want, jump straight to its page in the sidebar

This section complements the Search API Reference:

• The API reference focuses on the public request / response contract
• The SERP section focuses on what you can search, what you can control, and where to find the right engine-specific details

Request Example

The following /v1/serp request was executed during the 2026-03-26 docs refresh, using bing_videos as the example engine. In the request body, the engine field should use the scraper value from Supported Engines.

curl -X POST "https://run.xcrawl.com/v1/serp" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"engine":"bing_videos","q":"360"}'

• Authorization uses a Bearer token
• This is a real tested request, not a hand-written placeholder based on the schema

Response Example

The JSON below is trimmed from the same real response. Long strings, data URLs, and large arrays were shortened for readability, but the structure still comes from the live response body.

{
  "search_metadata": {
    "cached": true,
    "created_at": "2026-03-26 08:16:41 UTC",
    "id": "01KMMKETDC42XNJ0D76QQHCZ42",
    "json_endpoint": "https://serp.xcrawl.com/01KMMKETDC42XNJ0D76QQHCZ42.json",
    "processed_at": "2026-03-26 08:16:41 UTC",
    "raw_html_file": "https://serp.xcrawl.com/01KMMKETDC42XNJ0D76QQHCZ42.html",
    "status": "completed",
    "total_time_taken": 10
  },
  "search_parameters": {
    "engine": "bing_videos",
    "q": "360"
  },
  "total_credits_used": 1,
  "video_results": [
    {
      "channel": "Science Filmmaking Tips",
      "date": "Feb 2, 2016",
      "extracted_views": 756000,
      "length": "18:39",
      "link": "https://www.bing.com/videos/riverview/relatedvideo?q=360&&mid=B0496CDAD7A952FB968CB0496CDAD7A952FB968C&FORM=VRDGAR",
      "position": 1,
      "source": "756K views",
      "thumbnail": "data:image/webp;base64,UklGRjAQAABXRUJQVlA4ICQQAADwVgCdASrzAIgAP0WGt1WwKKUjM9r9E... [truncated data URL, 5559 chars]",
      "title": "How to Make 360° Video (VR) : Basic Workflow Explained",
      "views": "756K views"
    },
    {
      "_note": "28 more items omitted"
    }
  ]
}

What You Can Do Here

• Compare the supported engines and decide whether you need Google, Bing, DuckDuckGo, or a more specialized source
• Learn which parameters are shared across engines and which ones are engine-specific
• Check the required fields, filters, pagination controls, and localization options for a single engine

How To Read This Section

• If this is your first time with SERP, go in the order: overview -> supported engines -> common parameters -> engine page
• If you already know the engine, go straight to the engine page and use the parameter groups there
• Field descriptions are preserved from the live backend metadata so the docs stay close to what the engine actually supports

Usage Notes

• Requiredness should be read from the field-level must flag
• Parameters with the same name are not always interchangeable across engines
• For very large enum lists, this section shows the shape and examples while the live metadata remains the source of truth

Previous pageCrawl

Next pageOverview