Linkup Search

From 5 credits/call
ae_linkup_search

Search the web for factual answers, sources, or structured data to ground AI responses.

Search
From 5 credits/call

Pricing

From 5 credits/call
Search depthCharge
Standard / Not specified5 credits/call
Deep50 credits/call

Starting price applies to Search depth: Standard.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
depthenum (standard | deep)NoThe search depth to perform. Use "standard" for queries with direct answers, "deep" for complex research requiring analysis across multiple sources.standard
querystringYesNatural language search query. Full questions work best, e.g., "How does the new EU AI Act affect startups?"—
toDatestringNoFilter results to only include content published on or before this date. Format: YYYY-MM-DD.—
fromDatestringNoFilter results to only include content published on or after this date. Format: YYYY-MM-DD.—
maxResultsintegerNoMaximum number of results to return.—
includeImagesbooleanNoAllows you to receive image results alongside text results in your search responses. When set to true, Linkup will return relevant images related to your query, each with a URL and metadata.false
excludeDomainsarrayNoA list of domains to exclude from search results, e.g. ["reddit.com", "quora.com"]. Results from these domains will be filtered out.—
includeDomainsarrayNoA list of domains to restrict search results to, e.g. ["bbc.com", "reuters.com"]. Only results from these domains will be returned. Max 100 domains.—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_linkup_search' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "depth": "standard",
    "fromDate": "2026-09-01",
    "maxResults": 6,
    "query": "国家能源局 2026年9月底 新型储能 累计装机 167GW 435GWh 数据 是否官方"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "results": [
    {
      "content": "截至2026年9月底,中国新型储能装机达167 GW/435 GWh,同比增长63%,储能时长延长、利用率提升,2030年目标为300 GW。\n根据国家能源局10月30日发布的数据,截至2026年9月底,中国投运的新型储能装机达167 GW/435 GWh,同比增长63%。国家能源局在季度全国能源形势发布会上公布了上述数据。\n截至2026年9月底,中国新型储能装机达167 GW/435 GWh,同比增长63%,储能时长延长、利用率提升,2030年目标为300 GW。\n截至9月底,风电和光伏发电装机合计超过2",
      "favicon": "https://favicons.linkup.so?domain=www.indexbox.io",
      "name": "中国新型储能装机达167 GW/435 GWh,同比增长63% - 新闻和统计 - IndexBox",
      "publishedAt": "2026-11-05",
      "type": "text",
      "url": "https://www.indexbox.io/zh-hans/blog/chinas-new-type-energy-storage-capacity-reaches-167-gw435-gwh/"
    }
  ]
}

This example shows part of the response. Copied content is valid JSON.

Guides using this tool

See how this tool fits into real workflows