# Similarweb API: List top websites

> Lists Similarweb's most visited websites for a category and country, with rankings and engagement figures for the reported month. Anonymous view limits may restrict results, especially for country rankings.

Unofficial. Not affiliated with or endorsed by Similarweb.

- Page: https://fous.com/methods/similarweb.com/list-top-websites
- Method: `similarweb.com/list_top_websites`, version 1
- Website: similarweb.com
- Returns: month, rank, domain, category, rank change, visit duration, pages per visit, bounce rate, Similarweb link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `country` | string | no | `"worldwide"` | Country name or two-letter code, such as United States or US. Default: worldwide. Default "worldwide". |
| `category` | string | no | `"news and media"` | Top-level category name, such as news and media, e-commerce and shopping, or finance. Default: all. Default "all". |
| `max_results` | integer | no | `10` | Maximum websites to return, such as 25. Default: 50. Default 50. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "country": "worldwide",
  "category": "news and media",
  "max_results": 10
}
```

Its output:

```json
{
  "month": "2026-08-01",
  "websites": [
    {
      "rank": 1,
      "domain": "yahoo.co.jp",
      "category": "News and Media",
      "rank_change": 0,
      "pages_per_visit": 7.26,
      "similarweb_link": "https://www.similarweb.com/website/yahoo.co.jp/",
      "bounce_rate_percent": 33.64,
      "average_visit_duration": "00:08:32"
    },
    {
      "rank": 2,
      "domain": "yahoo.com",
      "category": "News and Media",
      "rank_change": 0,
      "pages_per_visit": 4.97,
      "similarweb_link": "https://www.similarweb.com/website/yahoo.com/",
      "bounce_rate_percent": 38.63,
      "average_visit_duration": "00:06:10"
    },
    {
      "rank": 3,
      "domain": "news.yahoo.co.jp",
      "category": "News and Media",
      "rank_change": 0,
      "pages_per_visit": 4.88,
      "similarweb_link": "https://www.similarweb.com/website/news.yahoo.co.jp/",
      "bounce_rate_percent": 28.07,
      "average_visit_duration": "00:06:28"
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"similarweb.com/list_top_websites","input":{"country":"worldwide","category":"news and media","max_results":10}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What are the top 25 most visited news and media websites in the United States right now, with their bounce rates and average visit duration?
- Pull Similarweb's ranking of the most popular e-commerce and shopping sites in Germany this month.
- I need a list of the 10 highest-traffic finance websites worldwide, including pages per visit and how their rank changed.
- Show me the most visited websites in Japan across all categories, according to similarweb.com.
- Which gaming sites get the most traffic in Brazil? Give me the top 20 with engagement stats.

## Input schema

```json
{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "default": "worldwide",
      "description": "Country name or two-letter code, such as United States or US. Default: worldwide."
    },
    "category": {
      "type": "string",
      "default": "all",
      "description": "Top-level category name, such as news and media, e-commerce and shopping, or finance. Default: all."
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum websites to return, such as 25. Default: 50."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "month",
    "websites"
  ],
  "properties": {
    "month": {
      "type": "string",
      "format": "date",
      "description": "First day of the month covered."
    },
    "websites": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "rank",
          "domain",
          "category",
          "rank_change",
          "average_visit_duration",
          "pages_per_visit",
          "bounce_rate_percent",
          "similarweb_link"
        ],
        "properties": {
          "rank": {
            "type": "integer"
          },
          "domain": {
            "type": "string"
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "rank_change": {
            "type": [
              "integer",
              "null"
            ]
          },
          "pages_per_visit": {
            "type": [
              "number",
              "null"
            ]
          },
          "similarweb_link": {
            "type": "string",
            "format": "uri"
          },
          "bounce_rate_percent": {
            "type": [
              "number",
              "null"
            ]
          },
          "average_visit_duration": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false
}
```

## See more

- [Similarweb API: Get website traffic](https://fous.com/methods/similarweb.com/get-website-traffic.md): Gets a website's monthly traffic estimate, rankings, engagement and top countries from Similarweb's free public overview. Traffic-source percentages withheld by the site are null; the site may limit anonymous views.
- [Twitch API: List top categories](https://fous.com/methods/twitch.tv/list-top-categories.md): Lists Twitch games and categories ranked by current live viewers, with content tags, box art and category links.
- [Amazon API: List Amazon Best Sellers](https://fous.com/methods/amazon.com/list-best-sellers.md): Lists current Amazon Best Sellers in the closest matching top-level category for a store country (United States, United Kingdom, Germany, India, Canada or Australia), up to 100 ranked products. Prices, ratings and photos may be missing.
- [Google API: List Google Play top charts](https://fous.com/methods/play.google.com/list-top-charts.md): Lists ranked Android apps or games from the Google Play top free, top paid or top grossing chart for a country and category.
- [CompaniesMarketCap API: List largest companies](https://fous.com/methods/companiesmarketcap.com/list-largest-companies.md): Ranks public companies worldwide, or by country and industry, by market cap, revenue, earnings, employees or dividend yield. When both a country and an industry are set, the industry ranking order is kept and only companies from that country are shown.
- [Twitch API: List top streams](https://fous.com/methods/twitch.tv/list-top-streams.md): Lists the most-watched live Twitch streams, optionally within a category and language. All-category results are limited to 30 streams; category results allow up to 100.
- [Spotify API: List top podcasts](https://fous.com/methods/open.spotify.com/list-top-podcasts.md): Lists Spotify's top or trending podcasts for a country in chart order, with rank, movement, publisher, artwork and Spotify link. Category charts exist only for some countries.
- [Polymarket API: List trending markets](https://fous.com/methods/polymarket.com/list-trending-markets.md): Lists the open Polymarket markets with the most trading in the last 24 hours. You can pick one category or list all of them; markets outside the named categories are labeled Other.
- [All Similarweb methods](https://fous.com/methods/similarweb.com.md)