Felo API PlatformFelo API Platform
Tous les endpoints Similarweb
v0.2.0-beta
OpenAPI 3.1.0

Acteurs de la SERP — agrégé

Serveur:https://openapi.felo.ai
Bibliothèques clientes

Website Analytics

​

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

Acteurs de la SERP — agrégé

​

Acteurs de la SERP — agrégé. La réponse suit l'enveloppe SimilarWeb v5 (meta + data).

Référence tarifaire

  • Mesure : comptage des résultats mesurés.
  • Estimation de référence par requête : USD 0.075.
  • Base de coût unitaire : USD 0.075.
  • Unité de ressource : similarweb_credit.
  • Multiplicateur client de référence : 1.0. Ne pas l'appliquer à nouveau à un montant client déjà réglé.
  • Les bases de coût ne déterminent pas le prix client final, y compris lorsqu'elles valent zéro.

Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.

Paramètres de requête
  • country
    enum
    constante:  
    ww

    Données mondiales uniquement ; les valeurs sont insensibles à la casse.

    valeurs
    • ww
  • end_date
    Type: string
    obligatoire
  • granularity
    enum
    constante:  
    monthly
    valeurs
    • monthly
  • keywords
    Type: string
    obligatoire

    Délimiteur d'éléments : ,. Au plus 1 élément délimité. Au moins 1 élément délimité.

  • limit
    Type: integer
    min.:  
    1
    max.:  
    20
    obligatoire

    Integer numbers.

  • offset
    Type: integer
    min.:  
    0
    max.:  
    100000

    Integer numbers.

  • start_date
    Type: string
    obligatoire
Réponses
  • 200
    Type: object

    Enveloppe SimilarWeb v5 (meta + data).

    • data
      Type: array object[]
      • clicks
        Type: number | null Format: double

        Somme des clics que le domaine reçoit pour le mot-clé analysé

      • domain
        Type: string | null

        Domaine du site web sans 'www.' (par exemple, 'example.com')

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

        Sous-domaine du site web sans 'www.' (par exemple, 'developer.example.com')

      • top_url
        Type: string | null

        L'url du site ayant la position organique la plus élevée pour le mot-clé analysé

      • top_url_position
        Type: integer | null Format: int32

        Position combinée la plus récente de top_url dans la période sélectionnée

      • traffic_share
        Type: number | null Format: double

        La part du trafic vers le site web

    • meta
      Type: object · Response62E957Bfd704_SimilarWebMeta

      Métadonnées de l'enveloppe de réponse SimilarWeb v5.

      • status
        Type: string
        obligatoire

        Statut en amont ; 'success' lors d'un appel réussi.

      • last_updated
        Type: string

        Date du point de données le plus récent disponible en amont (YYYY-MM-DD).

      • query
        Type: object

        Écho de pagination/tri le cas échéant (limit, offset, asc, sort).

      • request
        Type: object

        Écho complet de la requête normalisée en amont (paramètres tels que reçus).

    application/json
  • 400

    La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.

  • 401

    Une clé API Felo valide est requise.

  • 402

    La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.

  • 403

    Le compte n'est pas autorisé à effectuer cette opération.

  • 429

    Une limite de requêtes ou de dépenses a été atteinte.

  • 502

    Le service n'a pas pu terminer la requête.

  • 503

    L'API ou le service de facturation est temporairement indisponible.

  • 504

    Le service a expiré lors du traitement de la requête.

  • default

    Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur

    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
    }
  ]
}
SERP Players - Aggregated