API Referencia v2.0

KompletnĂˇ dokumentĂˇcia pre integrĂˇciu sĂ©mantickĂ˝ch analĂ˝z a GEO monitorovacĂch nĂˇstrojov SEOFLASH do vaĹˇich aplikĂˇciĂ.

Ăšvod

API SEOFLASH umoĹľĹuje vĂ˝vojĂˇrom programovo pristupovaĹĄ k naĹˇim nĂˇstrojom na analĂ˝zu entĂt, monitorovanie AI citĂˇciĂ a vĂ˝poÄŤet GEO skĂłre. VĹˇetky endpointy vracajĂş dĂˇta vo formĂˇte JSON a vyĹľadujĂş autentifikĂˇciu pomocou API kÄľĂşÄŤa.

ZĂˇkladnĂˇ URL: https://api.seoflash.sk/v2

AutentifikĂˇcia

Pre prĂstup k API je potrebnĂ˝ API kÄľĂşÄŤ, ktorĂ˝ zĂskate po registrĂˇcii v klientskej zĂłne. KÄľĂşÄŤ sa posiela v hlaviÄŤke kaĹľdĂ©ho requestu:

Authorization: Bearer YOUR_API_KEY

đź’» PrĂklad v cURL:
curl -H "Authorization: Bearer YOUR_API_KEY" https://api.seoflash.sk/v2/entity/analyze?url=example.com

Rate Limiting

Pre bezplatnĂ˝ ĂşÄŤet je limit 100 requestov za deĹ. PlatenĂ© ĂşÄŤty majĂş limit podÄľa zvolenĂ©ho balĂÄŤka. V hlaviÄŤke odpovede vĹľdy nĂˇjdete informĂˇciu o zostĂˇvajĂşcich requestoch:

                X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1640995200
            

Entity Analysis

GET /entity/analyze

VykonĂˇ analĂ˝zu entĂt na zadanej URL a vrĂˇti zoznam identifikovanĂ˝ch entĂt, ich typ a relevantciu.

Parametre

Parameter	Typ	Popis
url	string	URL strĂˇnky na analĂ˝zu (povinnĂ©)
depth	string	HÄşbka analĂ˝zy: basic / advanced (voliteÄľnĂ©, default: basic)

PrĂklad odpovede

                        
{
  "url": "https://example.com",
  "entities": [
    {
      "name": "SEOFLASH",
      "type": "Organization",
      "confidence": 0.98,
      "mentions": 5,
      "context": ["SEO", "agentĂşra", "Bratislava"]
    },
    {
      "name": "Bratislava",
      "type": "City",
      "confidence": 0.95,
      "mentions": 2,
      "context": ["hlavnĂ© mesto", "Slovensko"]
    }
  ],
  "analysis_time": "1.2s"
}
                        
                    

Citation Monitor

GET /citations/search

VyhÄľadĂˇva citĂˇcie zadanej entity v odpovediach AI modelov (ChatGPT, Perplexity, Gemini).

Parametre

Parameter	Typ	Popis
entity	string	NĂˇzov entity na vyhÄľadanie (povinnĂ©)
days	integer	PoÄŤet dnĂ spĂ¤tne (voliteÄľnĂ©, default: 30)
models	string	ÄŚiarkou oddelenĂ˝ zoznam modelov (napr. chatgpt,perplexity)

PrĂklad odpovede

                        
{
  "entity": "SEOFLASH",
  "total_citations": 18,
  "citations": [
    {
      "model": "ChatGPT",
      "date": "2026-02-25",
      "context": "... podÄľa analĂ˝zy SEOFLASH je GEO optimalizĂˇcia ...",
      "url": "https://chat.openai.com/share/..."
    },
    {
      "model": "Perplexity",
      "date": "2026-02-24",
      "context": "... agentĂşra SEOFLASH z Bratislavy ĹˇpecializujĂşca sa na ...",
      "url": "https://perplexity.ai/search/..."
    }
  ],
  "trend": "+15% oproti minulĂ©mu mesiacu"
}
                        
                    

GEO Score

GET /geo/score

VypoÄŤĂta GEO skĂłre pre zadanĂş URL na zĂˇklade sĂ©mantickej hustoty, ĹˇtruktĂşrovanĂ˝ch dĂˇt a autoritatĂvnych signĂˇlov.

Parametre

Parameter	Typ	Popis
url	string	URL strĂˇnky na analĂ˝zu (povinnĂ©)

PrĂklad odpovede

                        
{
  "url": "https://example.com",
  "geo_score": 78,
  "components": {
    "semantic_density": 82,
    "structured_data": 95,
    "authority_signals": 67,
    "entity_completeness": 73
  },
  "recommendations": [
    "Pridajte schĂ©mu pre autora ÄŤlĂˇnkov",
    "ZvĂ˝Ĺˇte poÄŤet internĂ˝ch prepojenĂ­ na kÄľĂşÄŤovĂ© entity",
    "Optimalizujte LCP pod 1.2s"
  ]
}
                        
                    

IndexNow

POST /indexnow/submit

OdoĹˇle poĹľiadavku na okamĹľitĂş re-indexĂˇciu zadanĂ˝ch URL pomocou protokolu IndexNow.

Request Body

                        
{
  "urls": [
    "https://example.com/novy-clanok",
    "https://example.com/aktualizovany-produkt"
  ],
  "key": "indexnow-api-key" // voliteÄľnĂ©, ak nie je nastavenĂ© v profile
}
                        
                    

PrĂklad odpovede

                        
{
  "status": "success",
  "submitted": 2,
  "failed": 0,
  "message": "URL boli ĂşspeĹˇne odoslanĂ© na indexĂˇciu"
}
                        
                    

ChybovĂ© kĂłdy

KĂłd	Popis
400	Bad Request â€“ chĂ˝bajĂşci alebo neplatnĂ˝ parameter
401	Unauthorized â€“ neplatnĂ˝ API kÄľĂşÄŤ
403	Forbidden â€“ nedostatoÄŤnĂ© prĂˇva pre danĂ˝ endpoint
404	Not Found â€“ endpoint neexistuje
429	Too Many Requests â€“ prekroÄŤenĂ˝ rate limit
500	Internal Server Error â€“ chyba na strane servera

PrĂklady integrĂˇcie

Python

                
import requests

API_KEY = "your_api_key"
BASE_URL = "https://api.seoflash.sk/v2"

headers = {
    "Authorization": f"Bearer {API_KEY}"
}

# AnalĂ˝za entĂ­t
response = requests.get(
    f"{BASE_URL}/entity/analyze",
    headers=headers,
    params={"url": "https://example.com"}
)

data = response.json()
print(f"NĂˇjdenĂ˝ch entĂ­t: {len(data['entities'])}")
                
            

JavaScript

                
const API_KEY = 'your_api_key';
const BASE_URL = 'https://api.seoflash.sk/v2';

// GEO Score
fetch(`${BASE_URL}/geo/score?url=https://example.com`, {
    headers: {
        'Authorization': `Bearer ${API_KEY}`
    }
})
.then(response => response.json())
.then(data => console.log('GEO Score:', data.geo_score))
.catch(error => console.error('Chyba:', error));
                
            

đź“ Potrebujete pomoc s integrĂˇciou?

ZĂskaĹĄ API kÄľĂşÄŤ

API Referencia v2.0

Ăšvod

AutentifikĂˇcia

Rate Limiting

Entity Analysis

Parametre

PrĂ­klad odpovede

Citation Monitor

Parametre

PrĂ­klad odpovede

GEO Score

Parametre

PrĂ­klad odpovede

IndexNow

Request Body

PrĂ­klad odpovede

ChybovĂ© kĂłdy

PrĂ­klady integrĂˇcie

Python

JavaScript

PrĂklad odpovede

PrĂklad odpovede

PrĂklad odpovede

PrĂklad odpovede

PrĂklady integrĂˇcie