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

Hráči SERP – agregace

Felo API Support
MIT
Server:https://openapi.felo.ai
Klientské knihovny
Shell Curl

Website Analytics

​

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

Website Analytics Operace

Hráči SERP – agregace

​

Hráči SERP – agregace. Odpověď odpovídá obálce SimilarWeb v5 (meta + data).

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
  • end_date
    Typ: string
    povinné
  • granularity
    enum
    const:  
    monthly
    hodnoty
    • monthly
  • keywords
    Typ: string
    povinné

    Oddělovač položek: ,. Nejvýše 1 oddělená položka. Alespoň 1 oddělená položka.

  • limit
    Typ: integer
    min:  
    1
    max:  
    20
    povinné

    Integer numbers.

  • offset
    Typ: integer
    min:  
    0
    max:  
    100000

    Integer numbers.

  • start_date
    Typ: string
    povinné
Odpovědi
  • 200
    Typ: object

    Obálka SimilarWeb v5 (meta + data).

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

        Součet kliknutí, která doména za analyzované klíčové slovo získává

      • domain
        Typ: string | null

        Doména webu bez 'www.' (např. 'example.com')

      • serp_features
        Typ: array string[] | string
      • site
        Typ: string | null

        Subdoména webu bez 'www.' (např. 'developer.example.com')

      • top_url
        Typ: string | null

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

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

        Nejvyšší nejnovější kombinovaná pozice top_url ve zvoleném časovém období

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

        Podíl návštěvnosti webu

    • meta
      Typ: object · Response62E957Bfd704_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/serp-players-aggregated
curl 'https://openapi.felo.ai/v1/beta/similarweb/search/serp-players-aggregated?end_date=2026-09&keywords=example&limit=1&start_date=2026-09' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "meta": {
    "status": "success",
    "last_updated": "2026-06-30",
    "request": {},
    "query": {}
  },
  "data": [
    {
      "site": null,
      "domain": null,
      "clicks": null,
      "traffic_share": null,
      "serp_features": [
        "string"
      ],
      "top_url_position": null,
      "top_url": null
    }
  ]
}

Obálka SimilarWeb v5 (meta + data).

SERP Players - Aggregated