Linkup Search
From 5 credits/call
ae_linkup_search
Search the web for factual answers, sources, or structured data to ground AI responses.
From 5 credits/call
Pricing
From 5 credits/call
| Search depth | Charge |
|---|---|
| Standard / Not specified | 5 credits/call |
| Deep | 50 credits/call |
Starting price applies to Search depth: Standard.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
depth | enum (standard | deep) | No | The search depth to perform. Use "standard" for queries with direct answers, "deep" for complex research requiring analysis across multiple sources. | standard |
query | string | Yes | Natural language search query. Full questions work best, e.g., "How does the new EU AI Act affect startups?" | — |
toDate | string | No | Filter results to only include content published on or before this date. Format: YYYY-MM-DD. | — |
fromDate | string | No | Filter results to only include content published on or after this date. Format: YYYY-MM-DD. | — |
maxResults | integer | No | Maximum number of results to return. | — |
includeImages | boolean | No | Allows 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 |
excludeDomains | array | No | A list of domains to exclude from search results, e.g. ["reddit.com", "quora.com"]. Results from these domains will be filtered out. | — |
includeDomains | array | No | A 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-KeyRequest 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
{
"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



