---
title: "Look up company profile by domain"
method: GET
path: "/v1/tech-lookup/companies/lookup"
tags: ["TechLookup"]
---

# Look up company profile by domain

`GET /v1/tech-lookup/companies/lookup`

## Request

- Base URL: `https://api.stackscan.com/api`
- URL: `https://api.stackscan.com/api/v1/tech-lookup/companies/lookup`
- Auth: HTTP bearer and API key in header `X-Tenant-Id`

Given a domain, returns the company behind it: name, industry, city,
country, address, LinkedIn URL, and how many technologies StackScan
tracks for that site. Deducts 1 Bulk Lookup Credit only when the
lookup finds data.

Rate limit: 500 requests per minute, counted per API token. Going over returns 429 with `error_code: rate_limited` and a `Retry-After` header in seconds. A 429 costs no credits. Traffic is also subject to a higher shared ceiling per network address, applied before authentication.

## Query parameters

- `domain` string, required
- `fresh` boolean

## Response `200`

Company profile for a domain (success). Returns Company Name, Industry, City, Country, Address, LinkedIn URL and total technologies tracked. No data: `{success: false, error: "No data available"}`. Deducts 1 Bulk Lookup Credit when success is true.

- object
  - `success` boolean, required
  - `domain` string, required
  - `last_updated` string, required
  - `company` object, required
    - `name` string, nullable, required
    - `industry` string, nullable, required
    - `city` string, nullable, required
    - `country` string, nullable, required
    - `address` string, nullable, required
    - `estimated_revenue_band` string, nullable, required
    - `linkedin_url` string, nullable, required
  - `total_technologies_tracked` integer, required

## Other responses

- `401`: Unauthenticated
- `402`: Insufficient Bulk Lookup Credits.
- `403`: Authorization error
- `422`: Validation error
- `429`: Rate limit exceeded. Costs no credits. Back off for the number of seconds in Retry-After.

---

[API](https://skmtc.dev/stackscan/apis/stackscan-api-reference.md) · [All operations](https://skmtc.dev/stackscan/apis/stackscan-api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/stackscan/apis/stackscan-api-reference/revisions/66531cd65f3a?raw)
