---
title: "[BETA] Get company relevance"
method: GET
path: "/companies/{company_id}/relevance"
tags: ["companies"]
---

# \[BETA\] Get company relevance

`GET /companies/{company_id}/relevance`

## Request

- Base URL: `https://api.getpg.ai/public-api/v1`
- URL: `https://api.getpg.ai/public-api/v1/companies/{company_id}/relevance`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/getpg/apis/pg-ai-public-api/docs/companies/:company_id/relevance/get.ts> (a function with typed inputs; its response is checked against the schema)

Ranked relevance signals for a single company — recent material changes, leadership moves, funding, product launches, hiring trends, technology mentions and strategic shifts — drawn from PG:AI insights, public filings and news, web pages, jobs and technologies. By default uses a material-changes query; pass `q` to override. Returns `{ items, total, page, per_page }`. `GET /companies/{company_id}/graph` is a legacy alias for this endpoint.

## Path parameters

- `company_id` string, required

## Query parameters

- `q` string
- `per_source` integer
- `date_from` string
- `date_to` string

## Response `200`

Success — `{ items, total, page, per_page }` envelope

- object: Response data

## Other responses

- `400`: Invalid company ID or parameters
- `401`: Unauthorized
- `403`: Access denied. Required: companies:read
- `500`: Unexpected error

---

[API](https://skmtc.dev/getpg/apis/pg-ai-public-api.md) - [All operations](https://skmtc.dev/getpg/apis/pg-ai-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getpg/apis/pg-ai-public-api/revisions/cc47d013c073?raw)