# Badania API dla Audytu SEO — Raport 2026

**Data:** 2026-02-08
**Zakres:** Bing Webmaster Tools API, Brave Search API, IndexNow API
**Cel:** Ocena możliwości integracji dla platformy NordaBiz (150 firm)

---

## 1. BING WEBMASTER TOOLS API

### Czy API istnieje?
✅ **TAK.** API oficjalnie wspierane przez Microsoft, dostępne via Microsoft Learn.

### Dostępne Endpointy

| Endpoint | Funkcja | Notatka |
|----------|---------|---------|
| `GetUrlSubmissionQuota` | Sprawdzenie pozostałego limitu zgłoszeń | Limity dzienne/miesięczne |
| **URL Submission (Single)** | Zgłoszenie pojedynczego URL | Indeksowanie natychmiastowe |
| **URL Submission (Batch)** | Zgłoszenie wielu URL jednocześnie | API URL submission (preferowane) |
| **Sitemaps Management** | Zgłoszenie/zarządzanie mapami witryny | — |
| **Rank & Traffic Stats** | Dane o rankingach i ruchu | Historyczne dane wydajności |
| **Link Details** | Analiza linków wychodzących | Backlinki do domeny |
| **Keyword Details** | Dane o słowach kluczowych | Wyniki dla queryów |
| **Crawl Stats** | Statystyki crawlowania przez Binga | HTTP status, blokady, indeksowanie (6 mies. historii) |

**Endpoint URL:** `https://ssl.bing.com/webmaster/api.svc/json/{METHOD_NAME}?apikey={API_KEY}`

### Autentykacja

| Typ | Szczegóły | Bezpieczeństwo |
|-----|-----------|----------------|
| **API Key** | Generowany per user w Bing Webmaster Tools → Settings → API Access | Prosty, ale jedna klucz dla wszystkich serwisów |
| **OAuth 2.0** | Rekomendowany, token dostępu generowany z Bing Webmaster Tools | Bezpieczniejszy, standard nowoczesny |

⚠️ **Ważne:** Jeśli klucz zostanie skompromitowany, musi być usunięty i wygenerowany nowy (wszystkie aplikacje tracą dostęp).

### Dane dostępne

- ✅ Zapytania wyszukiwania (search queries)
- ✅ Dane crawlowania (crawl statistics)
- ✅ Raporty wydajności SEO (rank & traffic)
- ✅ Zgłoszenia URL (URL submission)
- ⚠️ **Brak:** Realtime ranking position, detailed competitor analysis

### Limity i koszt

| Parametr | Wartość |
|----------|---------|
| **Rate Limit** | Zależy od planu (konkretne wartości w dokumentacji Azure) |
| **Limit URL dziennie** | Zależy od potwierdzenia domeny i historii |
| **Koszt** | **Bezpłatny** (wbudowany w Bing Webmaster Tools) |
| **Ogół limit** | HTTP 429 przy przekroczeniu |

### Czy jest istotny dla polskiego rynku?

⚠️ **OGRANICZONA ISTOTNOŚĆ**

| Metryka | Wartość | Wniosek |
|---------|---------|---------|
| Udział Binga w Polsce | ~3-4% (szacunek) | Znacznie poniżej 50% Google |
| Europejski kontekst | 3.95% (Europa), 90.25% (Google) | Drugorzędny kanał |
| Siła demograficzna | Wyższy purchasing power niż u Google | Wartościowi użytkownicy, ale mało |
| Yahoo (powered by Bing) | Marginalny w Polsce | Prawie żaden impact |

**Rekomendacja:** Dla 150 firm w Polsce — **NISKA ISTOTNOŚĆ**. Bardziej wartościowy dla anglojęzycznych rynków (USA, UK) lub ekspansji międzynarodowej.

### Złożoność implementacji dla 150 firm

| Aspekt | Poziom | Notatka |
|--------|--------|---------|
| Integracja techniczna | **Łatwy** | REST API, obsługuje Python, cURL |
| Onboarding firm | **Średni** | Każda firma musi mieć Bing Webmaster Tools + wygenerować API key |
| Zarządzanie kluczami | **Średni** | Jeden klucz per user (zarządzanie 150 userów) |
| Obsługa błędów | **Łatwy** | REST + JSON, standard |
| **Średni czas integracji na firmę** | **20-30 min** | Setup Bing + API key generation |

**Infrastruktura:** `O(150)` czasu onboardingu per firma, jedna integracja API. Dobrze skaluje się dla batch operations (Batch URL Submission).

---

## 2. BRAVE SEARCH API

### Obecne możliwości

Brave Search API zapewnia dostęp do **niezależnego indeksu WWW** (30+ miliardów stron, aktualizowanych codziennie).

| Możliwość | Status | Szczegóły |
|-----------|--------|-----------|
| **Web Search** | ✅ | 30B+ stron, 100M+ aktualizacji dziennie |
| **Citation Checking** | ✅ | AI-synthesized answers z cytatami (inline references) |
| **SERP Results** | ✅ | Tytuły, URL, opisy, snippety |
| **Local Search** | ✅ | Dedicated endpoint |
| **Images** | ✅ | Dedicated endpoint |
| **News** | ✅ | Dedicated endpoint |
| **Rankings Position** | ❌ | Brak — tylko search results |
| **Rank History** | ❌ | Brak |
| **Backlinks** | ❌ | Brak |

### Autentykacja

**Typ:** API Key via `X-Subscription-Token` header
**Metoda:** Token-based (POST/GET requests)
**Bezpieczeństwo:** Standard

```bash
curl -X GET "https://api.search.brave.com/res/v1/web/search?q=query" \
  -H "X-Subscription-Token: YOUR_TOKEN"
```

### Limity i ceny

| Plan | Koszt | Rate Limit | Zapytań/miesiąc | Użytek |
|------|-------|-----------|-----------------|--------|
| **Free** | $0 | 1 req/s | 2,000 | Testowanie |
| **Base** | $3 per 1K | 20 req/s | 20M | SMB |
| **Pro** | $5 per 1K | 50 req/s | Unlimited | Enterprise |
| **Enterprise** | Custom | Custom | Custom | Custom |

**CPM (Cost Per Mille):** $3-5 na 1000 zapytań (tańszy niż Google's $5 CPM)

**Wydajność:** 95% zapytań < 1 sekunda (Brave obsługuje 50M+ wyszukiwań dziennie)

### Dane SEO-relevantne

✅ **Możliwe do ekstrakcji:**
- SERP results (pozycje, snippety)
- Citation checking (dla fact-checking)
- AI-synthesized summaries (aggregate answers)
- Rerank feature (custom domain boosting/removal)

❌ **Niemożliwe:**
- Current ranking position dla konkretnej domeny
- Historical trend data
- Backlink analysis
- Keyword difficulty scores

### Zastosowania

| Przypadek | Wykonalne? | Rekomendacja |
|-----------|-----------|--------------|
| Citation Checking | ✅ **TAK** | Brave jest doskonały — NordaBiz już go używa |
| Competitor Analysis (snapshot) | ✅ **TAK** | Możliwe dla pojedynczych queryów (SERP snapshots) |
| SERP Feature Detection | ✅ **TAK** | Analiza wyników dla local pack, featured snippets, itp. |
| Real-time Rankings | ❌ | Nie — brak históry pozycji |
| Keyword Tracking | ❌ | Nie — brak Tracking API |

### Porównanie z Google Custom Search API

| Wymiar | Brave | Google |
|--------|-------|--------|
| **Niezależny indeks** | ✅ Własny 30B+ | ❌ Własny index, ale ograniczone API |
| **Cena** | $3-5 CPM | $5+ CPM |
| **Dostępność** | ✅ Open, Free tier istnieje | ⚠️ Ograniczone, wymaga kontaktu handlowego |
| **Jakość spam-filtering** | ✅ Wyraźnie zoptymalizowany | ✅ Świetny (ale droższy) |
| **SERP-specific data** | ✅ Full results | ✅ Full results |
| **Ranking position API** | ❌ | ❌ |
| **Privacy** | ✅ Brak trackingu | ❌ Analytics tracking |

**Wniosek:** Brave jest **lepszą alternatywą** dla SEO audytów opartych na SERP snapshots. Google Custom Search jest bardziej dla custom search experience niż SEO data.

---

## 3. INDEXNOW API

### Co to jest IndexNow?

**Definicja:** Protokół notyfikacyjny umożliwiający właścicielom stron natychmiastowe powiadomienie wyszukiwarek o zmianach treści (dodane, zaktualizowane, usunięte URL).

**Mechanizm:** Prosty ping do wyszukiwarek → priorytetowe crawlowanie zmienionego URL (zamiast czekać na autodiscovery).

**Format:** REST API + XML sitemap extensions

### Jak działa?

```
1. Właściciel strony → IndexNow API
2. Wysyła: { "urlList": ["url1", "url2"], "keyLocation": "url" }
3. Wyszukiwarka → Natychmiast crawluje URL
4. Efekt: Indeksacja w minuty (zamiast dni/tygodni)
```

### Które wyszukiwarki wspierają IndexNow?

✅ **Wspierające (2026):**
- **Bing** (Microsoft) — pełna obsługa
- **Yahoo** (powered by Bing) — pośrednia
- **Yandex** (rosyjski) — pełna obsługa (znaczący w Europie Wschodniej)
- **Seznam.cz** (czeski) — pełna obsługa
- **Naver** (koreański) — pełna obsługa
- **Yep** (nowy, independentny index) — pełna obsługa

❌ **Nie wspierające:**
- **Google** — Utrzymuje własne Indexing API (bardziej restrykcyjne, dla verified partnerships)

### Czy IndexNow jest dla audytu SEO?

⚠️ **NIE — głównie dla URL submission, ale ma elementy audytu.**

| Funkcja | Dostępna? | Notatka |
|---------|-----------|---------|
| **URL Submission** | ✅ **TAK** | Główne zastosowanie |
| **SEO Audit** | ⚠️ **Częściowo** | IndexNow dashboard ma "SEO audit, technical audit" |
| **Indexed Pages Report** | ✅ | Report indeksowanych stron (w Google Search Console) |
| **Crawl Data** | ❌ | Brak — IndexNow to submission-only |
| **Search Queries** | ❌ | Brak — to praca dla Bing Webmaster Tools |

**Główny cel:** Przyspieszenie indeksacji, nie analiza SEO.

### Integracja z NordaBiz — czy warte?

| Aspekt | Ocena | Wniosek |
|--------|-------|---------|
| Potrzeba dla 150 firm | ⭐⭐⭐ | Tak — jeśli firmy często publikują treści |
| Implementacja | ⭐⭐⭐⭐ | Bardzo łatwa (REST API) |
| Wpływ na SEO | ⭐⭐ | Przyspieszenie indeksacji, nie ranking |
| Koszt | ✅ Bezpłatny | — |
| Obsługa multilingual | ✅ | Wspiera wszystkie języki |

**Rekomendacja:** Wdrożyć IndexNow **na stronie NordaBiz głównej** (dla nowych firm, profili). Dla audytu SEO firm — **drugorzędne znaczenie** (to URL submission, nie analytics).

---

## PODSUMOWANIE I REKOMENDACJE

### Dla audytu SEO NordaBiz (150 firm)

| API | Prioritet | Uzasadnienie |
|-----|-----------|--------------|
| **Brave Search API** | 🔴 **WYSOKIE** | ✅ Już wdrażany, doskonały dla citation checking + SERP snapshots |
| **Bing Webmaster Tools API** | 🟡 **ŚREDNIE** | ⚠️ Limity rynku (3-4% Poland), ale użyteczny dla międzynarodowej ekspansji |
| **IndexNow API** | 🟡 **ŚREDNIE** | ✅ Przydatne dla szybkiego indexowania, ale nie dla analityki SEO |

### Strategia implementacji (Phase 1-2)

**Phase 1 (Q1 2026) — BRAVE SEARCH:**
- ✅ Rozszerzyć obecne citation checking
- ✅ Dodać SERP snapshot tracking dla wybranych konkurentów (5-10 firm)
- ✅ Zbudować "SERP Feature Detection" (local pack, featured snippets)

**Phase 2 (Q2 2026) — INDEXNOW + BING (opcjonalnie):**
- ✅ Wdrożyć IndexNow na stronie głównej NordaBiz
- ⚠️ Bing Webmaster API — tylko jeśli firmy chcą międzynarodowego reach (de, uk, belarusia)

### Złożoność implementacji

| API | Time-to-market | Infrastruktura | Uwagi |
|-----|----------------|-----------------|-------|
| Brave | 1-2 tygodnie | Minimize (już setup) | Rozszerzyć istniejące |
| IndexNow | 3-5 dni | Minimal (REST API) | Plugin/library dostępne |
| Bing | 2-3 tygodnie | Moderate (OAuth/key mgmt) | Per-firma onboarding |

---

## REFERENCJE

- [Bing Webmaster Tools API - Microsoft Learn](https://learn.microsoft.com/en-us/bingwebmaster/)
- [Bing Webmaster API Getting Access](https://learn.microsoft.com/en-us/bingwebmaster/getting-access)
- [Brave Search API Official](https://brave.com/search/api/)
- [Brave Search API vs Google Comparison](https://brave.com/search/api/guides/what-sets-brave-search-api-apart/)
- [IndexNow Official Documentation](https://indexnow.org/)
- [IndexNow Search Engines Support](https://indexnow.org/searchengines)
- [Bing Market Share Poland 2025](https://gs.statcounter.com/search-engine-market-share/all/poland)
- [Bing Webmaster URL Submission API](https://www.bing.com/webmasters/url-submission-api)
- [Best SERP APIs 2026 - Scrapfly](https://scrapfly.io/blog/posts/google-serp-api-and-alternatives)
- [Brave Search API Pricing and Rates](https://api-dashboard.search.brave.com/app/documentation/web-search/responses)

---

**Status dokumentu:** Draft
**Autor:** Claude Code
**Zaktualizowano:** 2026-02-08