Felo API PlatformFelo API Platform
Všechny endpointy Similarweb
v0.2.0-beta
OpenAPI 3.1.0

Klíčová slova webu

Server:https://openapi.felo.ai
Klientské knihovny

Website Analytics

​

Website traffic, engagement, audience, rankings and search data.

Klíčová slova webu

​

Klíčová slova webu. Odpověď odpovídá obálce SimilarWeb v5 (meta + data). Omezení data: rozsah start_date–end_date musí pokrývat 1 až 3 měsíční intervaly.

Cenová reference

  • Měření: podle počtu výsledků.
  • Referenční odhad požadavku: USD 0.075.
  • Nákladová základna jednotky: USD 0.075.
  • Jednotka prostředků: similarweb_credit.
  • Referenční multiplikátor zákazníka: 1.0. Znovu jej neaplikujte na již zúčtovanou částku zákazníka.
  • Nákladové základny neurčují konečnou cenu pro zákazníka, ani když jsou nulové.

Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.

Parametry dotazu
  • country
    enum
    const:  
    ww

    Pouze celosvětová data; hodnoty nerozlišují velikost písmen.

    hodnoty
    • ww
  • domain
    Typ: string
    minimální délka:  
    1
    maximální délka:  
    2048
    povinné
  • end_date
    Typ: string
    povinné
  • format
    enum
    const:  
    json
    hodnoty
    • json
  • granularity
    enum
    const:  
    monthly
    povinné
    hodnoty
    • monthly
  • limit
    Typ: integer
    min:  
    1
    max:  
    20
    povinné

    Integer numbers.

  • main_domain_only
    Typ: boolean
  • start_date
    Typ: string
    povinné
  • web_source
    enum
    const:  
    total
    hodnoty
    • total
Odpovědi
  • 200
    Typ: object

    Obálka SimilarWeb v5 (meta + data).

    • data
      Typ: array object[]
      • clicks
        Typ: number | null Formát: double

        Počet kliknutí z výsledků vyhledávání na web

      • competition
        Typ: integer | null Formát: int32

        Úroveň konkurence pro umístění reklamy na klíčové slovo.

      • keyword
        Typ: string | null

        Jedno klíčové slovo nebo název skupiny klíčových slov k analýze

      • position
        Typ: integer | null Formát: int32

        Nejnovější univerzální pozice klíčového slova ve zvoleném časovém rozsahu. Není k dispozici pro zemi 'world'.

      • primary_intent
        Typ: string | null

        Odhad toho, čeho se lidé hledající tato klíčová slova snaží dosáhnout.

      • secondary_intent
        Typ: string | null
      • serp_features
        Typ: array string[] | string
      • top_url
        Typ: string | null

        Adresa URL webu s nejvyšší organickou pozicí pro analyzované klíčové slovo

      • traffic_share
        Typ: number | null Formát: double

        Podíl návštěvnosti webu

      • url_count
        Typ: integer | null Formát: int32

        Počet adres URL pro klíčové slovo

    • meta
      Typ: object · ResponseF53Baa954733_SimilarWebMeta

      Metadata obálky odpovědi SimilarWeb v5.

      • status
        Typ: string
        povinné

        Stav upstream; při úspěšném volání 'success'.

      • last_updated
        Typ: string

        Datum nejnovějšího datového bodu dostupného upstream (YYYY-MM-DD).

      • query
        Typ: object

        Echo stránkování/řazení, pokud je relevantní (limit, offset, asc, sort).

      • request
        Typ: object

        Úplné echo normalizovaného upstream požadavku (parametry tak, jak byly přijaty).

    application/json
  • 400

    Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.

  • 401

    Je vyžadován platný API klíč Felo.

  • 402

    V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.

  • 403

    Účet nemá oprávnění tuto operaci provést.

  • 429

    Byl dosažen limit požadavků nebo útraty.

  • 502

    Služba nemohla požadavek dokončit.

  • 503

    API nebo fakturační služba je dočasně nedostupná.

  • 504

    Při zpracování požadavku vypršel časový limit služby.

  • default

    Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele

    application/json
Request Example for get/v1/beta/similarweb/search/website-keywords
curl 'https://openapi.felo.ai/v1/beta/similarweb/search/website-keywords?domain=example.com&end_date=2026-09&granularity=monthly&limit=1&start_date=2026-09' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "meta": {
    "status": "success",
    "last_updated": "2026-06-30",
    "request": {},
    "query": {}
  },
  "data": [
    {
      "keyword": null,
      "clicks": null,
      "traffic_share": null,
      "competition": null,
      "primary_intent": null,
      "secondary_intent": null,
      "position": null,
      "serp_features": [
        "string"
      ],
      "top_url": null,
      "url_count": null
    }
  ]
}
Website Keywords