Skip to main content

Cloudsway (Search, China Region)

An alternative search channel for the China region. Retrieve web results first, then summarize, RAG, rerank, or feed them to another model as needed.

  • Endpoint: GET /proxy/cloudsway/search
  • Required parameter: q
  • Common parameters: count, freshness, offset, enableContent, contentType, contentTimeout, mainText, sites, blockWebsites
  • Headers: Usually only Authorization is required; headers such as Pragma and Accept can be included at the caller's discretion
curl --location "$TURING_BASE_URL/proxy/cloudsway/search?q=%E6%97%A5%E6%9C%AC" \
  -H "Authorization: Bearer $TURING_API_KEY" \
  -H "Accept: */*"

Parameter descriptions:

  • q: Search query string; must not be empty.
  • count: Number of results to return; default 10, maximum 50, valid range 1–50.
  • freshness: Filter results by time; options: Day / Week / Month.
  • offset: Pagination offset; default 0. Setting this too high may return empty results.
  • enableContent: Whether to fetch a long summary of the web page; true returns a long summary, false does not; default false.
  • contentType: Format of the long summary; only applies when enableContent=true; options: HTML / MARKDOWN / TEXT; defaults to TEXT.
  • contentTimeout: Timeout in seconds for fetching the long summary; default 0, maximum 10; only applies when enableContent=true.
  • mainText: Whether to return the body excerpt most relevant to the query; only applies when enableContent=true.
  • sites: Restrict results to specified sites; provide the host only, e.g. baijiahao.baidu.com.
  • blockWebsites: Exclude results from specified sites; provide the host only, e.g. baijiahao.baidu.com.

Response fields are largely consistent with the Legacy Bing Proxy. Common fields include:

  • queryContext.originalQuery: The original query string.
  • webPages.value[]: Array of search results.
  • webPages.value[].name / url / snippet: Title, link, and short summary.
  • webPages.value[].datePublished: Publication date of the page; included for some results.
  • webPages.value[].mainText: Body excerpt most relevant to the query.
  • webPages.value[].siteName: Site name; included for some results.
  • webPages.value[].contentCrawled: Whether the long summary was successfully fetched.
  • webPages.value[].content: Long summary body text.
  • webPages.value[].logo / imageList / score: Site icon, image list, and content relevance score.
tip

If you only need standard search results, passing just q and count is usually sufficient. Only enable enableContent / mainText when you need to build enriched summaries or RAG context.

note

Both sites and blockWebsites require the host only — do not include the protocol. For example, use www.tiktok.com, not https://www.tiktok.com.