# Owler Search

## Overview

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

## Description

Search for companies on Owler by name or keyword, returning a list of matching companies with slugs, logos, domains, and profile URLs.

## 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/owler/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search for companies matching 'norton'

```json
[
  {
    "id": "15254378",
    "url": "https://www.owler.com/company/nortonlifelock",
    "logo": "https://s3.amazonaws.com/owler-image/logo/nortonlifelock_owler_20211115_162831_original.png",
    "name": "NortonLifeLock, Inc.",
    "slug": "nortonlifelock",
    "domain": "nortonlifelock.com"
  },
  {
    "id": "145118",
    "url": "https://www.owler.com/company/norton-rose-fulbright",
    "logo": "https://s3.amazonaws.com/owler-image/logo/norton-rose-fulbright_owler_20241206_222941_original.jpg",
    "name": "Norton Rose Fulbright, LLP",
    "slug": "norton-rose-fulbright",
    "domain": "nortonrosefulbright.com"
  },
  {
    "id": "191474",
    "url": "https://www.owler.com/company/norton-antivirus",
    "logo": "https://s3.amazonaws.com/owler-image/logo/norton-antivirus_owler_20200309_064538_original.png",
    "name": "Norton AntiVirus",
    "slug": "norton-antivirus",
    "domain": "norton.com"
  }
]
```

## Documentation

## Overview
The Owler Search endpoint finds companies on Owler by name or keyword, returning matching company records with slugs, logos, and profile URLs.

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

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Company name or keyword |

## Response fields
| Field | Type | Description |
|---|---|---|
| `[].name` | string | Company name |
| `[].slug` | string | Company slug |
| `[].url` | string | Owler profile URL |
| `[].domain` | string | Company domain |

## Notes
- The `slug` can be passed to the Company Info endpoint.
- Results may include companies with similar names.

## Main use cases
- Resolve company names to Owler slugs for detailed lookups
- Build company auto-complete features for CRM tools
- Discover competitors by searching industry keywords
- Validate and enrich lead company names against Owler database