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

Ranking dos principais sites do Similarweb

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

Website Analytics

​

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

Ranking dos principais sites do Similarweb

​

Retorna o ranking de sites de uma categoria do setor. category e limit são obrigatórios. limit deve estar entre 1 e 20. country aceita apenas dados mundiais (ww) e usa ww por padrão. offset controla a paginação. A resposta contém meta e 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
  • category
    Tipo: string
    tamanho mínimo:  
    1
    tamanho máximo:  
    191
    obrigatório
  • country
    enum
    const:  
    ww

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

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

    Integer numbers.

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

    Integer numbers.

Respostas
  • 200
    Tipo: object

    Envelope SimilarWeb v5 (meta + data).

    • data
      Tipo: array object[]
      • domain
        Tipo: string
      • rank
        Tipo: integer

        Integer numbers.

    • meta
      Tipo: object · ResponseC6C9032778Bd_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/website/top-sites-ranking
curl --request GET https://openapi.felo.ai/v1/beta/similarweb/website/top-sites-ranking \
  --header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
  --get \
  --data-urlencode category=Finance \
  --data-urlencode limit=5 \
  --data-urlencode country=ww \
  --data-urlencode offset=0
{
  "meta": {
    "query": {
      "limit": 5,
      "offset": 0
    },
    "request": {
      "category": "Finance",
      "country": "ww"
    },
    "status": "success",
    "last_updated": "2026-09-01"
  },
  "data": [
    {
      "domain": "example.com",
      "rank": 1
    }
  ]
}
Similarweb Top Sites Ranking