Felo API PlatformFelo API Platform
Všechny endpointy Similarweb
v0.2.0-beta
OpenAPI 3.1.0
Server:https://openapi.felo.ai
Klientské knihovny

Website Analytics

​

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

SimilarSites

​

SimilarSites. Odpověď odpovídá obálce SimilarWeb v5 (meta + data). Časové okno (omezení upstream poskytovatele SimilarWeb): start_date a end_date musí pokrývat PŘESNĚ 3 po sobě jdoucí měsíce — rozsah 1 nebo 2 měsíců je odmítnut s upstream chybou 120 („must span exactly 3 month(s)“). Tento rozsah musí být také nejnovějším podporovaným oknem SimilarWeb, které se každý měsíc posouvá dopředu; starší nebo mimo rozsah je odmítnut s chybou 101 („Dates not in range“). V praxi požadujte tři nejnovější dokončené měsíce (např. pokud je nejnovější publikovaný měsíc 2026-07, použijte start_date=2026-05 a end_date=2026-07). Přesný aktuálně podporovaný rozsah zjistíte voláním endpointu /describe SimilarWeb pro toto API.

Cenová reference

  • Účtování: počet měřených výsledků.
  • Referenční odhad požadavku: USD 0.375.
  • Základ jednotkových nákladů: USD 0.075.
  • Jednotka prostředku: similarweb_credit.
  • Referenční multiplikátor zákazníka: 1.0. Neaplikujte jej znovu na zúčtovanou částku zákazníka.
  • Nákladové základny neurčují konečnou cenu pro zákazníka, a to 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:  
    253
    povinné
  • end_date
    Typ: string
    povinné
  • granularity
    enum
    const:  
    monthly
    hodnoty
    • monthly
  • limit
    Typ: integer
    min:  
    1
    max:  
    20
    povinné

    Integer numbers.

  • main_domain_only
    Typ: boolean
  • offset
    Typ: integer
    min:  
    0
    max:  
    100000

    Integer numbers.

  • start_date
    Typ: string
    povinné
  • traffic_source
    Typ: string
  • web_source
    Typ: string enum
    hodnoty
    • desktop
    • mobile_web
    • total
Odpovědi
  • 200
    Typ: object

    Obálka SimilarWeb v5 (meta + data).

    • data
      Typ: array object[]
      • affinity
        Typ: number
      • category
        Typ: string
      • domain
        Typ: string
      • has_adsense
        Typ: boolean
      • rank
        Typ: integer

        Integer numbers.

    • meta
      Typ: object · Response7B51F63Afd06_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/website/similar-sites
curl 'https://openapi.felo.ai/v1/beta/similarweb/website/similar-sites?domain=cnn.com&end_date=2026-09&limit=1&start_date=2026-07' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "meta": {
    "query": {
      "limit": 5,
      "offset": 0,
      "asc": null,
      "sort": null
    },
    "request": {
      "format": "json",
      "domain": "cnn.com",
      "granularity": "monthly",
      "start_date": "2026-05-01",
      "end_date": "2026-07-31",
      "metrics": [
        "rank",
        "affinity",
        "has_adsense"
      ],
      "category": null
    },
    "status": "success",
    "last_updated": "2026-07-31"
  },
  "data": [
    {
      "domain": "bbc.com",
      "category": "News_and_Media",
      "rank": 95,
      "affinity": 1,
      "has_adsense": true
    }
  ]
}
SimilarSites