Web Search API

Search the web using multiple search engines (Google, DuckDuckGo, Bing, Baidu) with advanced filtering, geographic targeting, and pagination support.

POST/v1/web-search/*

Google Search

POST/v1/web-search/google

Search the web via Google with advanced operators, geographic targeting, language filtering, and pagination.

Parameters

ParameterTypeRequiredDescription
qstringRequiredSearch query string
locationstringOptionalGeographic location for localized results
languagestringOptionalLanguage filter for results
pageintegerOptional (default: 0)Page number for pagination
numintegerOptional (default: 10)Number of results per page

DuckDuckGo Search

POST/v1/web-search/duckduckgo

Search the web via DuckDuckGo with region filtering, date filtering, and pagination support.

Parameters

ParameterTypeRequiredDescription
qstringRequiredSearch query string
regionstringOptionalRegion filter for localized results
pageintegerOptional (default: 0)Page number for pagination

Bing Search

POST/v1/web-search/bing

Search the web via Bing with market targeting, geographic filters, safe search, and pagination.

Parameters

ParameterTypeRequiredDescription
qstringRequiredSearch query string
marketstringOptionalMarket/region targeting
ccstringOptionalCountry code filter
pageintegerOptional (default: 0)Page number for pagination

Baidu Search

POST/v1/web-search/baidu

Search the web via Baidu with Chinese language support, pagination, and advanced filtering.

Parameters

ParameterTypeRequiredDescription
qstringRequiredSearch query string
pageintegerOptional (default: 0)Page number for pagination
pnintegerOptionalResult offset for pagination

Response

Response
{
  "success": true,
  "message": "Google web search completed successfully",
  "data": {
    "search_information": {
      "total_results": 1250000
    },
    "organic_results": [
      {
        "title": "Large Language Models: A Survey",
        "link": "https://example.com/llm-survey",
        "snippet": "A comprehensive survey of large language models...",
        "position": 1
      }
    ],
    "people_also_ask": [],
    "relatedSearches": []
  }
}

Examples

import requests

API_KEY = "your_api_key_here"
BASE_URL = "https://api.qinyanai.com"

# Google web search
response = requests.post(
    f"{BASE_URL}/v1/web-search/google",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={"q": "large language models survey", "num": 10}
)

# DuckDuckGo search
response = requests.post(
    f"{BASE_URL}/v1/web-search/duckduckgo",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={"q": "machine learning tutorial", "region": "us-en"}
)

# Bing search
response = requests.post(
    f"{BASE_URL}/v1/web-search/bing",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={"q": "deep learning", "market": "en-US"}
)

# Baidu search (Chinese)
response = requests.post(
    f"{BASE_URL}/v1/web-search/baidu",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={"q": "人工智能最新进展"}
)