Perplexity-Compatible Search API

​

Overview

​

Install

pip install perplexityai

​

Usage

from perplexity import Perplexity

client = Perplexity(api_key="YOUR_API_KEY", base_url="https://api.edenai.run/v3")

search = client.search.create(
    query="latest Eden AI release notes",
    max_results=5,
    extra_body={"model": "tavily"},
)
for result in search.results:
    print(result.title, result.url, result.snippet)

curl -X POST https://api.edenai.run/v3/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "latest Eden AI release notes",
    "model": "tavily",
    "max_results": 5
  }'

curl -X POST https://api.edenai.run/v3/search/tavily \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Eden AI",
    "search_domain_filter": ["edenai.co"],
    "country": "FR"
  }'

​

Open WebUI

​

Request Fields

​

Response Structure

{
  "id": "4d2f1a2c-3f43-4f26-9f2b-0b2f6a4e9f1e",
  "results": [
    {
      "title": "Eden AI",
      "url": "https://www.edenai.co/",
      "snippet": "One API for all AI providers.",
      "date": null,
      "last_updated": null
    }
  ],
  "provider": "tavily",
  "cost": 0.008
}

• results[].snippet: The text snippet returned by the search provider.
• results[].title: The title of the page (empty string when not provided).
• results[].date and results[].last_updated: Always null because search providers do not return standardized timestamp metadata.
• provider and cost: Eden AI extensions indicating the executed provider and the cost in USD. These are also returned via x-edenai-provider and x-edenai-cost HTTP response headers.
• id: The Eden AI request identifier.
• With the x-edenai-metadata: enabled header, the response body also includes edenai_metadata.

​

Errors

• HTTP 400 for conflicting providers, missing providers, or a filter the provider does not support.
• HTTP 404 for unknown providers.
• HTTP 422 for schema validation errors or unrecognized fields.
• Provider errors: when a provider rejects the request with a 4xx status (such as 400, 404, 422 or 429), that status and the provider’s message are forwarded. The exceptions are 401 and 403, which concern Eden AI’s own provider credentials rather than your request: those, provider 5xx errors and outages all return HTTP 502.
• Authentication errors (401 or 403) and rate limits (429) return the platform {"detail": ...} format because they trigger before the route handler executes.

​

Limitations

• Recency filter: Date filters are not mapped yet, so Perplexity’s search_recency_filter and the providers’ own date parameters cannot be used here.
• Search depth: Searches run at the standard depth. For the deep tier, call POST /v3/universal-ai with web/search/<provider> and "depth": "deep" in input, which is billed at that tier’s price.

​

Pricing

​

Next Steps