# SimilarWeb Top Websites Ranking Scraper

> SimilarWeb Top Websites Ranking Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Retrieves structured data from SimilarWeb's public top 50 website rankings, filterable by country and category

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/similarweb?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/similarweb-top-websites-ranking-scraper-13d75689
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_swuaU8UH-tY6OAqa9GceV

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability similarweb-top-websites-ranking-scraper-13d75689 -d '<json body>'
```

Example prompt: Pull the SimilarWeb top 50 website rankings for the computers-electronics-and-technology category in the united-states and give me the domain, title, and category for each site.

## When to prefer this

Use this endpoint when you need structured, ranked website data from SimilarWeb's public top 50 lists without building your own scraper. Ideal for competitive research, market analysis, or validating whether specific domains appear in top rankings for a given country and category. Prefer this over manual scraping when you need clean JSON output with favicon, screenshot, and description fields included, and when pay-per-successful-call pricing is preferable to subscription models.

## Known failure modes

- Domain not in top 50 list returns no row for that domain
- Category or country slug not matching SimilarWeb's URL slugs returns empty or error
- Empty result set when all requested domains are outside the top 50 list (no charge)
- Invalid maxItems value outside 0-50 range may cause validation error
- Upstream SimilarWeb data unavailable causes failed run (no charge)

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count and an array of items, each containing the domain, title, URL, favicon URL, category, screenshot URL, description, and snapshot date for each website in the selected SimilarWeb top ranking. Fields may be null if not available. Also includes a product identifier ('similarweb').

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "country": {
   "type": "string",
   "default": "worldwide",
   "description": "Country URL slug from the top websites ranking, such as united-states. Use worldwide for the global list."
  },
  "domains": {
   "type": "array",
   "description": "Optional website domains or URLs to select from the chosen public top 50 ranking. Domains outside the list produce no row. Leave empty to return the full list."
  },
  "category": {
   "type": "string",
   "default": "all-categories",
   "description": "Category URL slug from the top websites ranking, such as computers-electronics-and-technology. Use all-categories for all categories."
  },
  "maxItems": {
   "type": "integer",
   "default": 50,
   "maximum": 50,
   "minimum": 0,
   "description": "Maximum rows to save from the selected ranking. Set 0 to use the public list limit of 50."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "url": null,
    "title": null,
    "domain": null,
    "favicon": null,
    "category": null,
    "screenshot": null,
    "description": null,
    "snapshotDate": null
   }
  ],
  "product": "similarweb"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/similarweb-top-websites-ranking-scraper-13d75689/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)