API за разработчици

findnix.eu Търсачка API

API-то на findnix.eu позволява на разработчиците да интегрират нашата функция за търсене в собствени приложения. API-то е безплатно и може да се използва без регистрация.

Основен URL

https://findnix.eu/api/search.php

Параметри

Примерна заявка

GET https://findnix.eu/api/search.php?q=Берлин&filter=web&lang=bg&page=1

Примерен отговор

{ "results": [ { "title": "Берлин — Уикипедия", "url": "https://bg.wikipedia.org/wiki/Берлин", "description": "Берлин е столицата...", "domain": "bg.wikipedia.org", "score": 85, "source": "searxng" } ], "total_count": 1000, "query": "Берлин", "page": 1, "filter": "web", "cache_hit": false, "response_ms": 342, "ai_summary": "Берлин е столицата и най-голям град на Германия..." }

Филтърни стойности

• web — Обща уеб търсене (SearXNG + Brave Search)
• news — Актуални новини
• images — Изображения от Pexels + Openverse (предоставя миниатюра, автор, лиценз)
• videos — Видеа от Pexels + SerpAPI
• science — Научни публикации (OpenAIRE + BASE, Отворен достъп)
• култура — Европейско културно наследство чрез Europeana

HTTP статус кодове

• 200 — Успех
• 400 — Невалидна търсена дума (твърде кратка)
• 429 — Прекалено много заявки (макс. 30/минута)
• 503 — Търсачката не е достъпна

Ограничения на заявките

Максимум 30 заявки на минута на сесия. Резултатите се кешират за 1 час — повторните идентични заявки се броят само веднъж и са по-бързи.

Забележки

• Не е необходима автентикация
• Отговорът винаги е в JSON (UTF-8)
• Моля, задайте информативен User-Agent: МоятаПриложение/1.0 (kontakt@пример.com)
• Комерсиално използване: моля, свържете се предварително

Въпроси относно API? Пишете ни: findnix@findnix.eu