Search

Search

Search the web with a Perplexity-shaped request.

Send a query and the provider as model (tavily, linkup, firecrawl, deepseek, perplexityai, zai; see GET /v3/search/models), optionally max_results. search_domain_filter is taken by tavily, linkup and perplexityai, country by tavily and perplexityai; any other provider answers either with a 400. Results come back as {title, url, snippet} items; provider and cost (USD) are Eden AI extensions. With the Perplexity SDK, pass the provider through extra_body={"model": "tavily"}.

post/v3/search

Request

  • Base URL
    https://api.edenai.run
  • Auth
    HTTP bearer

Request body

querystring required

The search query. At most 128 characters on deepseek.

modelstring nullable

Search provider, e.g. tavily. Optional when the provider is in the path (POST /v3/search/{provider}). List the ids with GET /v3/search/models.

max_resultsinteger

Most results to return (1-20). A provider may return fewer; on zai the results are cut to this number after the search.

search_domain_filterstring[] nullable

Domains to restrict results to, or, with a leading -, domains to exclude (-pinterest.com). Allow and deny entries cannot be mixed. Up to 20.

countrystring nullable

ISO 3166-1 alpha-2 country code to bias results toward, e.g. US.

Response

Successful Response

idstring required

Eden AI request id; quote it when reporting a problem.

providerstring required

Eden extension: provider that ran the search.

costnumber required

Eden extension: cost in USD.

Changes

No recorded changes to this operation across all 1 revision of this API.