# Similarweb Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/similarweb/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/similarweb-search |

## Description

Search the Similarweb database to retrieve websites, companies, mobile apps, search keywords, and technologies associated with a given domain or keyword.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/similarweb/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search for google.com

```json
{
  "apps": {
    "appStore": [],
    "googlePlay": []
  },
  "keywords": [
    "google",
    "google translate",
    "google maps",
    "google docs",
    "google drive",
    "google flights",
    "google scholar",
    "google gemini",
    "google map",
    "google tradutor"
  ],
  "websites": [
    {
      "name": "google.com",
      "image": "https://site-images.similarcdn.com/image?url=google.com&t=2&s=1&h=eb35e0fbafa3eb290132ffdfe47187d950d68daaa659ec1bd4b4e834b8f16461",
      "isVirtual": false
    },
    {
      "name": "google.com.br",
      "image": "https://site-images.similarcdn.com/image?url=google.com.br&t=2&s=1&h=f504c8926f9f375805be71b441f7e0075edd929c948130d744438f373adaf17c",
      "isVirtual": false
    },
    {
      "name": "google.com.hk",
      "image": "https://site-images.similarcdn.com/image?url=google.com.hk&t=2&s=1&h=8a5f5d19c15ef49cb7f696519e8e3a0c8624c4b3837ebd6f32b707650e0d8cc2",
      "isVirtual": false
    },
    {
      "name": "google.com.mx",
      "image": "https://site-images.similarcdn.com/image?url=google.com.mx&t=2&s=1&h=83f6c37012ec87b1250e08d4526d9c4e6ab2efe753b88a00221ad7f0b61937af",
      "isVirtual": false
    },
    {
      "name": "google.com.tw",
      "image": "https://site-images.similarcdn.com/image?url=google.com.tw&t=2&s=1&h=3233beffce0879e0ba5d45edbb1944a58b7a83662388554b3e7e2c2c8b55676a",
      "isVirtual": false
    },
    {
      "name": "google.com.vn",
      "image": "https://site-images.similarcdn.com/image?url=google.com.vn&t=2&s=1&h=98b085fee62d7c3114230d1e68facb8838af2e6d7cb538900fa8e8a315b9eb35",
      "isVirtual": false
    },
    {
      "name": "google.com.au",
      "image": "https://site-images.similarcdn.com/image?url=google.com.au&t=2&s=1&h=75e1999f2c7d28d56cad490b012b1ec4a120ecf8a656fc72d522258728d59cad",
      "isVirtual": false
    },
    {
      "name": "google.com.tr",
      "image": "https://site-images.similarcdn.com/image?url=google.com.tr&t=2&s=1&h=56f80540717eca7791d12ad63c8d821b0e8aad3378db7ac067f44c710829e0e5",
      "isVirtual": false
    },
    {
      "name": "google.com.ar",
      "image": "https://site-images.similarcdn.com/image?url=google.com.ar&t=2&s=1&h=a84e684d02bc6266e64492b5022004ff84c9146f836f0db9864d2adf4184b3d8",
      "isVirtual": false
    },
    {
      "name": "google.com.ua",
      "image": "https://site-images.similarcdn.com/image?url=google.com.ua&t=2&s=1&h=8835b452e239898cd81d835ee4b93695b013909af5853882c434b40f5adee3d4",
      "isVirtual": false
    }
  ],
  "companies": [],
  "technologies": []
}
```

### Search for amazon.com

```json
{
  "apps": {
    "appStore": [],
    "googlePlay": []
  },
  "keywords": [
    "amazon",
    "amazon prime",
    "amazon prime video",
    "amazon uk",
    "amazon de",
    "amazon canada",
    "amazon india",
    "amazon jobs",
    "amazon stock",
    "amazone"
  ],
  "websites": [
    {
      "name": "amazon.com",
      "image": "https://site-images.similarcdn.com/image?url=amazon.com&t=2&s=1&h=43a07f575342a8fbb74cd3ca3ebf33760f2fbfbff603546fb4f7208244147dcc",
      "isVirtual": false
    },
    {
      "name": "amazon.com.br",
      "image": "https://site-images.similarcdn.com/image?url=amazon.com.br&t=2&s=1&h=ffbbda96260c8a0db9be9d4d4f04e76e327ebf480e86e0c625b3f4538a9bae4c",
      "isVirtual": false
    },
    {
      "name": "amazon.com.mx",
      "image": "https://site-images.similarcdn.com/image?url=amazon.com.mx&t=2&s=1&h=4ec42ab5be5ff4e02bfbc9dfc91f0355aac94c47a2d2953f79ffeaa584ac80a0",
      "isVirtual": false
    },
    {
      "name": "amazon.com.au",
      "image": "https://site-images.similarcdn.com/image?url=amazon.com.au&t=2&s=1&h=0433f91f2de5720b6422f8bbd688498ad8bb572c15bfb89f3808b8ac6b9b3818",
      "isVirtual": false
    },
    {
      "name": "amazon.com.tr",
      "image": "https://site-images.similarcdn.com/image?url=amazon.com.tr&t=2&s=1&h=407a09187beabb8042f30715b56fa452a8c1e048beb58e67cd841f04b4b4575d",
      "isVirtual": false
    },
    {
      "name": "amazon.com.be",
      "image": "https://site-images.similarcdn.com/image?url=amazon.com.be&t=2&s=1&h=27c3b82b3543ad384a97c08dc9098297fa8c92a13dff8f970ae00579697c5dcf",
      "isVirtual": false
    },
    {
      "name": "amazon.com.in",
      "image": "https://site-images.similarcdn.com/image?url=amazon.com.in&t=2&s=1&h=c00e149ede72e7a286ad6d01f00ae2fe15b5f486fcddd9a53008bc6d4434d864",
      "isVirtual": false
    },
    {
      "name": "amazon.com.sg",
      "image": "https://site-images.similarcdn.com/image?url=amazon.com.sg&t=2&s=1&h=37e0466bf2c6f7c40f1ffd478aad0a7d3ee306a828ad4636e8dae662556d60e8",
      "isVirtual": false
    },
    {
      "name": "amazon.com.tw",
      "image": "https://site-images.similarcdn.com/image?url=amazon.com.tw&t=2&s=1&h=31d41b49fc05eb05a1a8b6a14c99efee596f405390169a055fb0f2e392ee3e7a",
      "isVirtual": false
    },
    {
      "name": "amazon.com.jp",
      "image": "https://site-images.similarcdn.com/image?url=amazon.com.jp&t=2&s=1&h=655a9e7aba4af27277f4ec56d7e6b054960d5c38ec400aa10aeb697be93183ce",
      "isVirtual": false
    }
  ],
  "companies": [
    {
      "name": "Amazon.com, Inc.",
      "domain": "amazon.com",
      "logoUrl": "https://static-us-east-1.similarcdn.com/si/company_data/merged_v2/firmographics_logos/1b45ef2ee6d94a124859c7819de99e6c10a2529fdcdc9bed0344eb8e17468ae6.jpg"
    },
    {
      "name": "Amazon.com, Inc.",
      "domain": "amazon.in",
      "logoUrl": "https://static-us-east-1.similarcdn.com/si/company_data/merged_v2/firmographics_logos/1b45ef2ee6d94a124859c7819de99e6c10a2529fdcdc9bed0344eb8e17468ae6.jpg"
    },
    {
      "name": "Amazon.com, Inc.",
      "domain": "amazon.co.jp",
      "logoUrl": "https://static-us-east-1.similarcdn.com/si/company_data/merged_v2/firmographics_logos/1b45ef2ee6d94a124859c7819de99e6c10a2529fdcdc9bed0344eb8e17468ae6.jpg"
    },
    {
      "name": "Amazon.com, Inc.",
      "domain": "amazon.de",
      "logoUrl": "https://static-us-east-1.similarcdn.com/si/company_data/merged_v2/firmographics_logos/1b45ef2ee6d94a124859c7819de99e6c10a2529fdcdc9bed0344eb8e17468ae6.jpg"
    },
    {
      "name": "Amazon.com, Inc.",
      "domain": "amazon.co.uk",
      "logoUrl": "https://static-us-east-1.similarcdn.com/si/company_data/merged_v2/firmographics_logos/1b45ef2ee6d94a124859c7819de99e6c10a2529fdcdc9bed0344eb8e17468ae6.jpg"
    },
    {
      "name": "Amazon.com, Inc.",
      "domain": "amazon.it",
      "logoUrl": "https://static-us-east-1.similarcdn.com/si/company_data/merged_v2/firmographics_logos/1b45ef2ee6d94a124859c7819de99e6c10a2529fdcdc9bed0344eb8e17468ae6.jpg"
    },
    {
      "name": "Amazon.com, Inc.",
      "domain": "amazon.com.br",
      "logoUrl": "https://static-us-east-1.similarcdn.com/si/company_data/merged_v2/firmographics_logos/1b45ef2ee6d94a124859c7819de99e6c10a2529fdcdc9bed0344eb8e17468ae6.jpg"
    },
    {
      "name": "Amazon.com, Inc.",
      "domain": "amazon.ca",
      "logoUrl": "https://static-us-east-1.similarcdn.com/si/company_data/merged_v2/firmographics_logos/1b45ef2ee6d94a124859c7819de99e6c10a2529fdcdc9bed0344eb8e17468ae6.jpg"
    },
    {
      "name": "Amazon.com, Inc.",
      "domain": "amazon.fr",
      "logoUrl": "https://static-us-east-1.similarcdn.com/si/company_data/merged_v2/firmographics_logos/1b45ef2ee6d94a124859c7819de99e6c10a2529fdcdc9bed0344eb8e17468ae6.jpg"
    },
    {
      "name": "Amazon.com, Inc.",
      "domain": "amazon.es",
      "logoUrl": "https://static-us-east-1.similarcdn.com/si/company_data/merged_v2/firmographics_logos/1b45ef2ee6d94a124859c7819de99e6c10a2529fdcdc9bed0344eb8e17468ae6.jpg"
    }
  ],
  "technologies": []
}
```

### Search for apple.com

```json
{
  "apps": {
    "appStore": [],
    "googlePlay": []
  },
  "keywords": [
    "apple",
    "apple tv",
    "apple watch",
    "apple music",
    "apple store",
    "apple stock",
    "apple macbook neo",
    "apple id",
    "appletv",
    "apple neo"
  ],
  "websites": [
    {
      "name": "apple.com",
      "image": "https://site-images.similarcdn.com/image?url=apple.com&t=2&s=1&h=f81bb484ae2fd14ee7d230f4992fcf6f0e071e846a94e3f49400616e3f9c5063",
      "isVirtual": false
    },
    {
      "name": "apple.com.cn",
      "image": "https://site-images.similarcdn.com/image?url=apple.com.cn&t=2&s=1&h=5d6a86bc69ab6e20c0b6da8d8686f00e3d53fd1467cd86603481894775730cd9",
      "isVirtual": false
    },
    {
      "name": "apple.com.in",
      "image": "https://site-images.similarcdn.com/image?url=apple.com.in&t=2&s=1&h=e848e90f18b6655c6ff9efeb1599c3650cbe6c440d28aff56659f1cc6d5f0d5b",
      "isVirtual": false
    },
    {
      "name": "apple.com.tr",
      "image": "https://site-images.similarcdn.com/image?url=apple.com.tr&t=2&s=1&h=58ad83dd930d1eee89d230d544c971106292dfbf8d899846f0f2513e860cad2f",
      "isVirtual": false
    },
    {
      "name": "apple.com.id",
      "image": "https://site-images.similarcdn.com/image?url=apple.com.id&t=2&s=1&h=a74051e6db2ec5ccd4a92530aa0fcd32972e5a349ac7b1516e3200e65dae46b7",
      "isVirtual": false
    },
    {
      "name": "apple.com.uk",
      "image": "https://site-images.similarcdn.com/image?url=apple.com.uk&t=2&s=1&h=b54e430f88a4200d7b7b38c07f00609eb83a9df0fcceb05c125cd2e415602846",
      "isVirtual": false
    },
    {
      "name": "apple.com.com",
      "image": "https://site-images.similarcdn.com/image?url=apple.com.com&t=2&s=1&h=389bf0171e2906dc2aba57b4f475c7913c60a7187a6713aa1e2d3436148081ee",
      "isVirtual": false
    },
    {
      "name": "apple.com.au",
      "image": "https://site-images.similarcdn.com/image?url=apple.com.au&t=2&s=1&h=dee8004c61e2966189b036eb6a324c6594cf12d488c9aa52b6504e33eb4dae7e",
      "isVirtual": false
    },
    {
      "name": "apple.com.ng",
      "image": "https://site-images.similarcdn.com/image?url=apple.com.ng&t=2&s=1&h=633a7aeb790991f06e57e9582e64eecdfd7c7de356c5680886dfb2a7068faadc",
      "isVirtual": false
    },
    {
      "name": "apple.com.br",
      "image": "https://site-images.similarcdn.com/image?url=apple.com.br&t=2&s=1&h=e081632d063e65b68077126c4a5ac6d4568a136940c8462a681c62330dde556f",
      "isVirtual": false
    }
  ],
  "companies": [],
  "technologies": []
}
```

## Documentation

## Overview
Search the Similarweb database to discover related websites, companies, mobile apps, search keywords, and technologies for any domain or keyword.

## Quickstart
```
GET https://api.piloterr.com/v2/similarweb/search?query=google.com
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Domain name or keyword to search (e.g. `google.com`, `amazon`) |

## Response fields
| Field | Type | Description |
|---|---|---|
| `apps` | object | Mobile apps associated with the query, split by store |
| `apps.appStore` | array | iOS apps from the Apple App Store |
| `apps.googlePlay` | array | Android apps from Google Play |
| `apps[].id` | string | App identifier |
| `apps[].name` | string | App name |
| `apps[].image` | string | App icon URL |
| `apps[].store` | string | Store identifier (`apple` or `google`) |
| `apps[].appKey` | string | Unique app key used by Similarweb |
| `apps[].ratings` | integer | Total number of user ratings |
| `apps[].publisher` | string | App publisher name |
| `keywords` | array | Top related search keywords for the queried entity |
| `websites` | array | Related or similar websites |
| `websites[].name` | string | Website domain name |
| `websites[].image` | string | Website favicon/logo URL |
| `websites[].isVirtual` | boolean | Whether the website is a virtual property |
| `companies` | array | Companies associated with the queried domain |
| `companies[].name` | string | Company name |
| `companies[].domain` | string | Company domain |
| `companies[].logoUrl` | string | Company logo URL |
| `technologies` | array | Technologies detected on the queried domain |

## Notes
- The `query` parameter accepts both full domain names (e.g. `google.com`) and plain keywords (e.g. `amazon`)
- Results may vary: some queries return rich company and app data, others return only keywords and websites
- `apps.appStore` and `apps.googlePlay` may be empty arrays if no apps are directly linked to the queried domain

## Main use cases
- Identify competitor websites and related domains for market intelligence
- Discover which mobile apps are linked to a specific brand or domain
- Extract top search keywords associated with a domain for SEO and content strategy
- Enrich CRM and prospecting workflows with technology and company footprint data
- Build domain similarity graphs for audience overlap and competitive benchmarking