Skip to main content
POST
Search With Provider

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

provider
string
required

Body

application/json

Request body for POST /v3/search.

Perplexity's Search API shape (query, max_results, search_domain_filter, country) plus model, the Eden AI provider that runs the search. Fields of Perplexity's API that no provider here maps to (search_recency_filter, max_tokens_per_page, ...) are rejected rather than silently dropped.

query
string
required

The search query.

Minimum string length: 1
model
string | null

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_results
integer
default:10

Number of results to return (1-20).

Required range: 1 <= x <= 20
search_domain_filter
string[] | null

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

Required array length: 1 - 20 elements
country
string | null

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

Pattern: ^[A-Za-z]{2}$

Response

Successful Response

Search results, in Perplexity's response shape. provider and cost are Eden extensions.

id
string
required

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

results
SearchResult · object[]
required
provider
string
required

Eden extension: provider that ran the search.

cost
number
required

Eden extension: cost in USD.