Felo API PlatformFelo API Platform
Todos os endpoints de Similarweb
v0.2.0-beta
OpenAPI 3.1.0

Participantes da SERP — agregado

Servidor:https://openapi.felo.ai
Bibliotecas Cliente

Website Analytics

​

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

Participantes da SERP — agregado

​

Participantes da SERP — agregado. A resposta segue o envelope do SimilarWeb v5 (meta + data).

Referência de preços

  • Medição: contagem de resultados medidos.
  • Estimativa de referência por requisição: USD 0.075.
  • Base de custo unitário: USD 0.075.
  • Unidade de recurso: similarweb_credit.
  • Multiplicador de referência do cliente: 1.0. Não o aplique novamente a um valor de cliente já liquidado.
  • As bases de custo não definem o preço final do cliente, inclusive quando forem zero.

Apenas metadados de referência, não uma cotação da conta, um preço garantido ou um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.

Parâmetros de Consulta
  • country
    enum
    const:  
    ww

    Apenas dados mundiais; os valores não diferenciam maiúsculas de minúsculas.

    valores
    • ww
  • end_date
    Tipo: string
    obrigatório
  • granularity
    enum
    const:  
    monthly
    valores
    • monthly
  • keywords
    Tipo: string
    obrigatório

    Delimitador de itens: ,. No máximo 1 item delimitado. No mínimo 1 item delimitado.

  • limit
    Tipo: integer
    mín:  
    1
    máx:  
    20
    obrigatório

    Integer numbers.

  • offset
    Tipo: integer
    mín:  
    0
    máx:  
    100000

    Integer numbers.

  • start_date
    Tipo: string
    obrigatório
Respostas
  • 200
    Tipo: object

    Envelope SimilarWeb v5 (meta + data).

    • data
      Tipo: array object[]
      • clicks
        Tipo: number | null Formato: double

        Soma dos cliques que o domínio recebe para a palavra-chave analisada

      • domain
        Tipo: string | null

        Domínio do site sem 'www.' (por exemplo, 'example.com')

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

        Subdomínio do site sem 'www.' (por exemplo, 'developer.example.com')

      • top_url
        Tipo: string | null

        A url do site com a posição orgânica mais alta que se classifica para a palavra-chave analisada

      • top_url_position
        Tipo: integer | null Formato: int32

        Posição combinada mais recente de topo do top_url no período selecionado

      • traffic_share
        Tipo: number | null Formato: double

        A parcela do tráfego para o site

    • meta
      Tipo: object · Response62E957Bfd704_SimilarWebMeta

      Metadados do envelope de resposta do SimilarWeb v5.

      • status
        Tipo: string
        obrigatório

        Status do upstream; 'success' em uma chamada bem-sucedida.

      • last_updated
        Tipo: string

        Data do ponto de dados mais recente disponível no upstream (YYYY-MM-DD).

      • query
        Tipo: object

        Eco de paginação/ordenação quando aplicável (limit, offset, asc, sort).

      • request
        Tipo: object

        Eco completo da requisição normalizada do upstream (parâmetros conforme recebidos).

    application/json
  • 400

    Não foi possível processar a requisição. Verifique os parâmetros da requisição.

  • 401

    É necessária uma chave de API da Felo válida.

  • 402

    A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.

  • 403

    A conta não tem permissão para realizar esta operação.

  • 429

    Um limite de requisições ou de gastos foi atingido.

  • 502

    O serviço não pôde concluir a requisição.

  • 503

    A API ou o serviço de cobrança está temporariamente indisponível.

  • 504

    O serviço atingiu o tempo limite ao processar a requisição.

  • default

    Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor

    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