# Owler Search API Documentation

<p><strong>Owler Search API</strong> searches companies on Owler by name or website domain. Each hit has the id, name, short name, slug, domain, ticker symbol, logo and Owler URL. Pass the slug to the other Owler endpoints.</p><p>Owler returns at most 30 hits and has no paging, so this endpoint has no page parameter. <code>total</code> is the number of matches Owler reports. <code>count</code> is the number of hits in this response.</p><p>A query with a dot and no spaces, such as <code>stripe.com</code>, is read as a website domain. The response then holds only the companies with exactly that domain. It is empty when no company has it.</p><p>The data is what a logged-out visitor sees on Owler.</p>

- **Documentation:** [https://scrappa.co/docs/owler-api/owler_search](https://scrappa.co/docs/owler-api/owler_search)
- **API group:** Owler API
- **Endpoint:** `GET https://scrappa.co/api/owler/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | Yes | Company name or website domain, 1 to 100 characters. Example: stripe. |

## Example response

```json
{
    "data": {
        "count": 1,
        "query": "stripe",
        "total": 899,
        "results": [
            {
                "id": 100441,
                "url": "https://www.owler.com/company/stripe",
                "logo": "https://s3.amazonaws.com/owler-image/logo/stripe_owler.png",
                "name": "Stripe, Inc.",
                "slug": "stripe",
                "domain": "stripe.com",
                "short_name": "Stripe",
                "ticker_symbol": null
            }
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a value is invalid. This response is not billable. |
| 503 | Upstream Unavailable | Owler could not be reached or returned data in an unexpected format. Retry shortly. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)