canonical: https://jentic.com/apis/owler.com/owler-main

# Owler

Search for information on companies using a website, ticker symbol, or company name and retrieve detailed company profiles including revenue, employee counts, founding dates, and industry classifications. Access competitive intelligence data including competitor lists, company news feeds, and blog posts. The API offers both basic and premium company data tiers with fuzzy search capabilities for flexible matching.

## For AI agents

Look up company profiles, competitor lists, and news feeds by company name, website URL, or ID. Returns firmographic data, revenue estimates, and competitive intelligence.

## Scope

Does not handle contact-level enrichment, email lookup, or financial transaction data - use for company-level intelligence and competitive research only.

## Capabilities

- Search companies by name, ticker, website URL, or PermID with basic and fuzzy matching
- Retrieve detailed company profiles including revenue, employee count, and industry data
- Discover competitor relationships for any company by ID or website URL
- Access premium company intelligence with extended firmographic detail
- Pull company news feeds and blog post activity for specified organizations

## Use cases

### Competitive Intelligence Research

Identify and monitor competitors for any company using the competitor endpoints. The API returns competitor lists by company ID or website URL, with premium endpoints providing deeper competitive intelligence including market positioning data. Agents can build competitive landscapes programmatically without manual research.

Example prompt: Retrieve the competitor list for company ID 12345 using the `/v1/company/competitor/id` endpoint and return the top 5 competitors with their company names

### Company Data Enrichment

Enrich CRM records or lead databases with firmographic data by looking up companies via their website URL or name. The API returns revenue estimates, employee counts, founding dates, headquarters locations, and industry classifications. Basic search supports exact matching while fuzzy search handles partial or misspelled company names.

Example prompt: Look up the company at website 'salesforce.com' using `/v1/company/url/{website}` and extract the revenue, employee count, and industry classification

### Company News Monitoring

Track news and blog mentions for specific companies by pulling their feed data. The API supports querying feeds by company ID or website URL, returning recent news items, press releases, and blog posts associated with the organization. Useful for sales teams monitoring prospect activity or analysts tracking market developments.

Example prompt: Fetch the news feed for the company at website 'stripe.com' using `/v1/feed/url` and return the 3 most recent news items

### AI Agent Company Research via Jentic

AI agents can discover and call Owler endpoints through Jentic to automate company research workflows. An agent searching for competitor data receives the matching Owler operation with its input schema, executes the call with Jentic-managed credentials, and returns structured company intelligence without direct API key management.

Example prompt: Search Jentic for 'find competitors of a company', load the Owler competitor endpoint schema, and execute a competitor lookup for company ID 67890

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/v1/company/search` | Search company by ticker, website, name, or PermID |
| GET | `/v1/company/fuzzysearch` | Fuzzy search company by name, address, or phone |
| GET | `/v1/company/id/{companyId}` | Get company profile by ID |
| GET | `/v1/company/url/{website}` | Get company profile by website URL |
| GET | `/v1/company/competitor/id/{companyId}` | Get competitor list by company ID |
| GET | `/v1/companypremium/id/{companyId}` | Get premium company data by ID |
| GET | `/v1/feed` | Get news feeds for given company IDs |
| GET | `/v1/feed/url` | Get news feeds for given company websites |

## Key resources

- **Company** — Search, retrieve basic and premium company profiles by ID, URL, or name
- **Competitor** — Get competitor lists for companies by ID or website URL
- **Feed** — Retrieve news and blog feeds for companies by ID or website URL

## Why Jentic

- **Setup:** Wiring Owler by hand means placing your access key in the custom user_key header on every company-intelligence call and paging feed and search results yourself. Through Jentic you install once, import the Owler API from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** Owler puts the company id in the URL path (`/v1/company/id/{companyId}`), so a rule can pin your agent to one company for reads like its profile, competitors, or premium detail. You choose the operations it may call, so broad search or fuzzy-search operations are not included unless you add them.
- **Credential handling:** Your Owler user_key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'find competitors for a company' or 'look up a company profile', and Jentic returns the matching Owler operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Clearbit** — Real-time company and contact enrichment with broader data attributes
- **Crunchbase** — Startup and funding-focused company data with investment round details
- **FullContact** — Person and contact enrichment to pair with company-level Owler data
- **Hunter** — Email finder and verification for outreach to companies discovered via Owler

## FAQ

### What authentication does the Owler API use?

The Owler API uses an API key passed in the request header as `user_key`. Through Jentic, this key is stored encrypted in your Jentic One instance and agents receive scoped access tokens without the raw key entering their context.

### Can I find competitors for a company using the Owler API?

Yes. Use the `/v1/company/competitor/id/{companyId}` or `/v1/company/competitor/url/{website}` endpoints to retrieve competitor lists. Premium competitor endpoints provide additional competitive intelligence detail including deeper relationship data.

### What is the difference between basic and premium company endpoints?

Basic endpoints like `/v1/company/id/{companyId}` return core firmographic data including name, website, industry, and employee count. Premium endpoints at `/v1/companypremium/id/{companyId}` return extended data with additional fields such as detailed revenue breakdowns and deeper organizational information.

### How do I search for a company when I only have a partial name?

Use the `/v1/company/fuzzysearch` endpoint which accepts partial company names, addresses, or phone numbers and returns best-match results. For exact matches on ticker symbols, website URLs, or full names, use `/v1/company/search` instead.

### How do I retrieve company news through Jentic?

Search Jentic for 'get company news feed', load the returned operation schema for `/v1/feed/url`, and execute with the target company website. Install with pip install jentic and authenticate through Jentic One, the self-hosted execution layer, to get your API key.

### Can I limit what my agent is allowed to do with the Owler API?

Yes. Because you run Jentic One yourself, your own rules decide which Owler operations and credentials the agent can use. Since Owler carries the company id in the URL path, such as `/v1/company/id/{companyId}`, you can pin the agent to a single company for reads like its profile, competitors, or premium detail. You also choose the exact operations it may call, so broad `/v1/company/search` or `/v1/company/fuzzysearch` stay off limits unless you add them.
