Dumpling AI Search Web

From 22.5 credits/call
ae_dumplingai_search_web

Search the web for organic results and snippets using DumplingAI.

Search
From 22.5 credits/call

Pricing

From 22.5 credits/call
ConditionCharge
Each search22.5 credits
Each requested result when scraping is enabledAdd 7.5 credits

Search and the requested result scraping are charged separately.

Without scraping, only the search fee applies. When scraping is enabled and its count is omitted, three results are charged. The starting price applies when result scraping is disabled.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
pageintegerNoNo parameter description.—
querystringYesNo parameter description.—
countrystringNo2-letter country code forwarded as `gl`.—
languagestringNoInterface language forwarded as `hl`.—
locationstringNoFree-form location context forwarded to the provider.—
dateRangeenum (pastHour | pastDay | pastWeek | pastMonth | pastYear | anyTime)NoTemporal filter applied to the search results.—
requestSourceenum (API | WEB | MAKE_DOT_COM | ZAPIER | N8N | PLAYGROUND | DEFAULT_AUTOMATION | AGENT_PREVIEW | AGENT_LIVE | AUTOPILOT | STUDIO)NoOptional identifier describing where the API request originated.—
scrapeOptionsobjectNoNo parameter description.—
scrapeOptions.formatenum (markdown | html | screenshot)NoNo parameter description.—
scrapeOptions.cleanedbooleanNoNo parameter description.—
scrapeResultsbooleanNoWhen true, the service will scrape top organic results for rich content.false
numResultsToScrapeintegerNoNo parameter description.3

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_dumplingai_search_web' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "country": "us",
    "language": "en",
    "query": "USB 3.2 active optical cable external hard drive DAS works transparently UASP 10Gbps long cable"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "credits": 1,
  "organic": [
    {
      "displayedLink": "https://www.act-connectivity.com › en-us › usb-c-active-...",
      "link": "https://www.act-connectivity.com/en-us/usb-c-active-optical-cable-for-connection-over-long-distance",
      "position": 1,
      "snippet": "USB 3.2 Gen2 cables support a maximum length of 1 meter with 10Gbps throughput; ... Transferring data to an external hard drive at a distance greater than 1 to 2 ...",
      "title": "USB-C Active Optical Cable (AOC) for long distances"
    }
  ],
  "peopleAlsoAsk": [
    {
      "question": "Are USB extenders illegal?"
    }
  ],
  "relatedSearches": [
    {
      "query": "Optical USB-C cable"
    }
  ],
  "searchParameters": {
    "engine": "google",
    "gl": "us",
    "hl": "en",
    "q": "USB 3.2 active optical cable external hard drive DAS works transparently UASP 10Gbps long cable",
    "tbs": null,
    "type": "search"
  }
}

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