# Gloom Companies Lookup

> Gloom Companies Lookup is a paid API for AI agents from api.gloom.sh, paid per call via x402, $0.3/call, status unknown (last checked 2026-11-01).

Retrieve company profile data (sector, industry, country, employee count, website) for one or more stock symbols

## Facts

- Endpoint: GET https://api.gloom.sh/v1/companies?utm_source=zero.xyz
- Price: $0.3/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gloom-companies-lookup-8a5b4067
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4c-IEQ066hH-XGXD6FZh1

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gloom-companies-lookup-8a5b4067
```

Example prompt: Can you look up the company profile for AAPL and MSFT — I want to know their sector, industry, country, employee count, and website?

## When to prefer this

Use this endpoint when you need structured company profile metadata (sector, industry, country, employees, website) for one or more publicly traded companies identified by their ticker symbols. Prefer this over generic web search when you need clean, structured, machine-readable company data for downstream processing, screening, or enrichment. Best suited for equity research, portfolio enrichment, and company classification workflows.

## Known failure modes

- Invalid or unrecognized ticker symbols return empty data or an error
- Missing required 'symbols' query parameter causes a 400-level error
- Payment not included or insufficient USDC results in a 402 Payment Required response
- Rate limiting may occur if too many requests are made in rapid succession
- Delisted or OTC stocks may have incomplete or missing profile data

## How this service works

Gloom is a free, open-source finance terminal for desktop and TUI with charts, news, filings, portfolios, alerts, and plugins.

## Output

Returns an array of company objects, each containing the stock symbol, sector, industry, country of domicile, employee count, and official website URL for each requested ticker.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "symbols"
     ],
     "properties": {
      "symbols": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "sector": "Consumer Defensive",
    "symbol": "AAPL",
    "country": "US",
    "website": "https://www.costco.com",
    "industry": "Discount Stores",
    "employees": 355000
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-companies-lookup-8a5b4067/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.gloom.sh](https://www.zero.xyz/host/api.gloom.sh/llms.txt)