External links

A company is identified differently by everyone who tracks it: LinkedIn by a slug, the SEC by a CIK, an exchange by a ticker, a sales tool by its domain, Wikidata by a QID. The external-links endpoint returns every one of those in a single shape — the platform, the platform-native identifier, and a ready-to-use URL where one exists.

This page is the forward index: given a company, list every identifier we hold for it. To go the other way — given a LinkedIn slug, domain, ticker, or CIK, find the matching company, in bulk — use GET /v1/entities/lookup.

Use this endpoint when you want to:

Enrich your own company records with identifiers you do not yet hold.
Join Particle companies to a dataset keyed by LinkedIn, ticker, or CIK.
Build a “find this company on…” UI without per-platform URL templates.

List external links for a company

Identify the company by slug, domain, or ID.

curl "https://api.particle.pro/v1/companies/apple.com/external-links" \
  -H "X-API-Key: $PARTICLE_API_KEY"

const res = await fetch(
  "https://api.particle.pro/v1/companies/apple.com/external-links",
  { headers: { "X-API-Key": process.env.PARTICLE_API_KEY } },
);
const { data } = await res.json();

import os, requests

r = requests.get(
    "https://api.particle.pro/v1/companies/apple.com/external-links",
    headers={"X-API-Key": os.environ["PARTICLE_API_KEY"]},
)
links = r.json()["data"]

{
  "data": [
    {
      "platform": { "name": "domain", "display_name": "Website Domain", "type": "website" },
      "identifier": "apple.com",
      "url": "https://apple.com"
    },
    {
      "platform": { "name": "linkedin", "display_name": "LinkedIn", "type": "social_profile" },
      "identifier": "company/apple",
      "url": "https://www.linkedin.com/company/apple/"
    },
    {
      "platform": { "name": "ticker", "display_name": "Stock Ticker", "type": "other" },
      "identifier": "AAPL"
    }
  ],
  "has_more": false
}

Every identifier here is accepted by GET /v1/entities/lookup, so the two endpoints round-trip.

Platforms

Platform	Identifier	Coverage
`domain`	`apple.com`	Near-universal
`linkedin`	`company/apple`	Broad
`twitter`, `facebook`, `instagram`	Handle	Partial
`ticker`	`AAPL`	Public companies only
`sec`	CIK, e.g. `0000320193`	SEC filers only
`wikidata`	QID, e.g. `Q312`	Notable companies only

A company can carry several tickers — a dual-listed or multi-class company holds one row per symbol. Every other platform is one identifier per company.Symbols are read live from the company’s ticker records rather than stored alongside the other identifiers, so they are never stale.

Behavior and edge cases

Identifiers also appear inline on the company

GET /v1/companies/{id} returns the same list as external_links alongside the company, so fetching a single company does not need a second call. The list endpoint GET /v1/companies omits it.

`url` is absent where no canonical page exists

A ticker symbol identifies a company but has no single web page that represents it, so those rows carry an identifier and no URL.

Discovery is asynchronous

Identifiers that come from a company’s own record — domain, ticker, CIK, QID — are present as soon as the company is. Social profiles are discovered separately, so a newly created company may not carry them yet.

Getting started

Recipes

Podcasts

Companies

Knowledge graph

Alerts

Errors

List external links for a company

Platforms

Behavior and edge cases

Identifiers also appear inline on the company

`url` is absent where no canonical page exists

Discovery is asynchronous

​List external links for a company

​Platforms

​Behavior and edge cases

​Identifiers also appear inline on the company

​url is absent where no canonical page exists

​Discovery is asynchronous

​Related

List external links for a company

Platforms

Behavior and edge cases

Identifiers also appear inline on the company

`url` is absent where no canonical page exists

Discovery is asynchronous

Related