Яндекс Поиск

Веб-поиск на базе Яндекса, оптимизированный для русского и кириллического контента. Два совместимых интерфейса: Tavily и Brave Search.

Заметка

Полная спецификация параметров: /api-docs

Эндпоинты

Метод	Эндпоинт	Совместимость
POST	/v1/search/yandex	Tavily API
GET	/v1/search/yandex	Brave Search API

Tavily-совместимый API

Drop-in замена для Tavily Search API. Идеально для AI-агентов (Claude, GPT, LangChain).

cURL

curl -X POST "https://proxy.unoapi.ru/v1/search/yandex" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "лучшие рестораны москвы",
    "max_results": 10
  }'

TypeScript

const response = await fetch('https://proxy.unoapi.ru/v1/search/yandex', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    query: 'лучшие рестораны москвы',
    search_depth: 'basic',
    max_results: 10
  })
});

const data = await response.json();
console.log(data.results);
// [{ title: '...', url: '...', content: '...', score: 0.95 }, ...]

Python

import requests

response = requests.post(
    'https://proxy.unoapi.ru/v1/search/yandex',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'query': 'лучшие рестораны москвы',
        'search_depth': 'basic',
        'max_results': 10
    }
)

data = response.json()
for result in data['results']:
    print(f"{result['title']}: {result['url']}")

Go

package main

import (
  "bytes"
  "encoding/json"
  "fmt"
  "net/http"
)

type SearchRequest struct {
  Query       string   `json:"query"`
  SearchDepth string   `json:"search_depth,omitempty"`
  MaxResults  int      `json:"max_results,omitempty"`
}

func main() {
  body, _ := json.Marshal(SearchRequest{
    Query:       "лучшие рестораны москвы",
    SearchDepth: "basic",
    MaxResults:  10,
  })

  req, _ := http.NewRequest("POST", "https://proxy.unoapi.ru/v1/search/yandex", bytes.NewBuffer(body))
  req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
  req.Header.Set("Content-Type", "application/json")

  client := &http.Client{}
  resp, err := client.Do(req)
  if err != nil {
    panic(err)
  }
  defer resp.Body.Close()

  var data map[string]interface{}
  json.NewDecoder(resp.Body).Decode(&data)
  fmt.Printf("%+v\n", data)
}

Пример ответа

{
  "query": "лучшие рестораны москвы",
  "results": [
    {
      "title": "Лучшие рестораны Москвы 2026 — рейтинг и отзывы",
      "url": "https://example.com/restaurants",
      "content": "Рейтинг лучших ресторанов Москвы по отзывам посетителей...",
      "score": 0.95
    }
  ]
}

Brave-совместимый API

Drop-in замена для Brave Search API.

cURL

curl "https://proxy.unoapi.ru/v1/search/yandex?q=погода+москва&count=10&country=ru" \
  -H "Authorization: Bearer YOUR_API_KEY"

TypeScript

const params = new URLSearchParams({
  q: 'погода москва',
  count: '10',
  country: 'ru',
  search_lang: 'ru'
});

const response = await fetch(`https://proxy.unoapi.ru/v1/search/yandex?${params}`, {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});

const data = await response.json();
console.log(data.web.results);

Python

import requests

params = {
    'q': 'погода москва',
    'count': 10,
    'country': 'ru',
    'search_lang': 'ru'
}

response = requests.get(
    'https://proxy.unoapi.ru/v1/search/yandex',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params=params
)

data = response.json()
for result in data['web']['results']:
    print(f"{result['title']}: {result['url']}")

Go

package main

import (
  "encoding/json"
  "fmt"
  "net/http"
  "net/url"
)

func main() {
  params := url.Values{
    "q":           {"погода москва"},
    "count":       {"10"},
    "country":     {"ru"},
    "search_lang": {"ru"},
  }

  req, _ := http.NewRequest("GET", "https://proxy.unoapi.ru/v1/search/yandex?"+params.Encode(), nil)
  req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

  resp, err := (&http.Client{}).Do(req)
  if err != nil {
    panic(err)
  }
  defer resp.Body.Close()

  var data map[string]interface{}
  json.NewDecoder(resp.Body).Decode(&data)
  fmt.Printf("%+v\n", data)
}

Пример ответа

{
  "type": "search",
  "query": { "original": "погода москва" },
  "web": {
    "results": [
      {
        "title": "Погода в Москве на сегодня",
        "url": "https://example.com/weather/moscow",
        "description": "Прогноз погоды в Москве..."
      }
    ]
  }
}

Фильтрация по доменам

Tavily API поддерживает include_domains и exclude_domains для точной настройки результатов.

# Поиск только по определённым доменам
curl -X POST "https://proxy.unoapi.ru/v1/search/yandex" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "новости технологий",
    "include_domains": ["habr.com", "vc.ru"],
    "max_results": 10
  }'

Фильтр по времени

Brave API поддерживает параметр freshness:

• pd — за последние 24 часа
• pw — за последнюю неделю
• pm — за последний месяц
• py — за последний год

Интеграция с AI-агентами

API оптимизирован для использования как tool в AI-агентах.

TypeScript

// Интеграция с AI-агентом (Claude, GPT, LangChain)
async function searchTool(query: string): Promise<string> {
  const response = await fetch('https://proxy.unoapi.ru/v1/search/yandex', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      query,
      search_depth: 'advanced',
      max_results: 5
    })
  });

  const data = await response.json();
  return data.results.map((r: any) =>
    `[${r.title}](${r.url})\n${r.content}`
  ).join('\n\n');
}

Python

import requests

def search_tool(query: str) -> str:
    """AI-agent tool для поиска в русском вебе"""
    response = requests.post(
        'https://proxy.unoapi.ru/v1/search/yandex',
        headers={
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/json'
        },
        json={'query': query, 'search_depth': 'advanced', 'max_results': 5}
    )
    results = response.json()['results']
    return '\n\n'.join(
        f"[{r['title']}]({r['url']})\n{r['content']}"
        for r in results
    )

Совет

Используйте search_depth: "advanced" для AI-агентов — это даст более подробные сниппеты для анализа.

Кэширование

Результаты кэшируются на 5 дней. Закэшированные запросы тарифицируются по сниженной ставке (10% от базовой цены).

Поддерживаемые языки

API автоматически определяет язык запроса. Оптимизирован для кириллицы: 🇷🇺 🇺🇦 🇧🇾 🇰🇿

Миграция

https://api.tavily.com/search
https://proxy.unoapi.ru/v1/search/yandex

https://api.search.brave.com/res/v1/web/search
https://proxy.unoapi.ru/v1/search/yandex

Осторожно

UnoAPI Search оптимизирован для русскоязычного контента. Для англоязычного поиска рекомендуем оригинальные API.