Web Link Search - Developer Guide

Web Link Search returns relevant links for a prompt across selected non-X sources such as web, Hacker News, Reddit, Wikipedia, YouTube, and Arxiv.

Endpoint

text

POST https://api.desearch.ai/desearch/ai/search/links/web

Example request

bash

curl --request POST 'https://api.desearch.ai/desearch/ai/search/links/web' \
  --header 'Authorization: $DESEARCH_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "recent AI search benchmark comparisons",
    "tools": ["web", "hackernews", "reddit", "arxiv"],
    "date_filter": "PAST_MONTH",
    "count": 10
  }'

Python example

python

import os
import requests

response = requests.post(
    "https://api.desearch.ai/desearch/ai/search/links/web",
    json={
        "prompt": "recent AI search benchmark comparisons",
        "tools": ["web", "hackernews", "reddit", "arxiv"],
        "date_filter": "PAST_MONTH",
        "count": 10,
    },
    headers={"Authorization": os.environ["DESEARCH_API_KEY"], "Content-Type": "application/json"},
    timeout=60,
)
response.raise_for_status()
print(response.json())

When to use this vs AI Search

Use case	Recommended endpoint
Need only source links/results	`POST /desearch/ai/search/links/web`
Need links plus a generated final summary	`POST /desearch/ai/search` with `result_type: LINKS_WITH_FINAL_SUMMARY`
Need SERP-style web results only	`GET /web`