Perplexity Search

5 credits/call
ae_perplexity_search

Search the web to retrieve ranked results, including titles, URLs, and snippets, without AI-generated summaries.

Search
5 credits/call

Pricing

5 credits/call
ConditionCharge
Each call5 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
querystring | arrayYesSearch query string or list of search query strings.—
countrystringNoCountry filter as ISO 3166-1 alpha-2 code.—
max_tokensintegerNoMaximum total tokens returned across all pages.10000
max_resultsintegerNoMaximum number of results to return.10
display_server_timebooleanNoWhether to include server processing time in the response.false
max_tokens_per_pageintegerNoMaximum number of tokens returned per page.4096
search_domain_filterarrayNoDomain filters.—
search_recency_filterenum (hour | day | week | month | year)NoRecency filter.—
search_language_filterarrayNoLanguage filters.—
search_after_date_filterstringNoOnly include results published after this date. Format MM/DD/YYYY.—
last_updated_after_filterstringNoOnly include results updated after this date. Format MM/DD/YYYY.—
search_before_date_filterstringNoOnly include results published before this date. Format MM/DD/YYYY.—
last_updated_before_filterstringNoOnly include results updated before this date. Format MM/DD/YYYY.—

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_perplexity_search' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "max_results": 6,
    "query": "TAPPI T 411 vs ISO 3034 corrugated board caliper thickness measurement pressure difference"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "id": "86ea68f6-9fb5-4769-bd44-d6e5f57c7de4",
  "results": [
    {
      "date": "2020-07-21",
      "last_updated": "2026-11-02",
      "snippet": "# Thickness Testing\nThickness testing measures the width/thickness of corrugated board.\nIt is used to determine caliper and to compare variations between samples.\n...\n## Equipment used for Thickness Testing:\n##### Exact Automatic Micrometer: Model DW\nby E.",
      "title": "Thickness Testing | Center for Packaging and Unit ... - Unit Load",
      "url": "https://www.unitload.vt.edu/facilities/corrugated-packaging-lab/thickness-testing.html"
    }
  ]
}

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

Guides using this tool

See how this tool fits into real workflows