Particle: Get Company

Get one company profile from its Particle slug, domain, or ID.

Tool ID: particle_get_company

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'particle_get_company',
  {
    "id": "id_123"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute particle_get_company --input '{
  "id": "id_123"
}' --json

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "id": "id_123",
    "name": "Example"
  }
}

Use deepline describe particle_get_company --json for the latest machine-readable contract.

Input reference

Returns a single company by slug (e.g., ‘apple’), domain (e.g., ‘apple.com’), or ID.

Name	Type	Required	Default	Details
`payload.id`	`string`	Yes	—	Company slug (e.g., ‘apple’, ‘tesla’), domain (e.g., ‘apple.com’), or ID

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.description`	`string`	No	—	Company description
`result.data.external_links`	`array \| null`	No	—	Known third-party profiles and identifiers (LinkedIn, social, domain, Wikidata, SEC CIK, tickers). Returned by GET /v1/companies/{id}. The list endpoint omits it.
`result.data.external_links[].attributes`	`array \| null`	No	—	Optional platform-specific metadata: audience size, profile fields, account status, and related signals. The set varies by platform and grows over time — clients should treat unknown attribute names as additive.
`result.data.external_links[].attributes[].category`	`string`	No	—	Broad grouping for the attribute. Today’s known values are audience_size, content, profile, and account_status — the set is open and may grow without a versioning event, so clients should treat unrecognised categories as additive rather than invalid.
`result.data.external_links[].attributes[].name`	`string`	Yes	—	Platform-native attribute name (e.g. ‘subscribers’, ‘followers’, ‘views’, ‘handle’). Vocabulary varies by platform. Use Category to group related attributes if you don’t recognise the Name.
`result.data.external_links[].attributes[].observed_at`	`string`	No	—	When this attribute was last observed from the upstream source. Omitted when unavailable. Format: `date-time`.
`result.data.external_links[].attributes[].value`	`unknown`	Yes	—	Attribute value. JSON type matches the Category: numbers for audience_size/content, strings for profile/account_status (with bool for flags). Null when the underlying source is unset.
`result.data.external_links[].identifier`	`string`	No	—	Platform-native identifier (numeric id, slug, handle, or full URL). Empty for the ‘website’ platform, where the URL is the canonical reference.
`result.data.external_links[].platform`	`object`	Yes	—	—
`result.data.external_links[].platform.display_name`	`string`	Yes	—	Human-readable name suitable for UI display (e.g. ‘Apple Podcasts’, ‘X (Twitter)’).
`result.data.external_links[].platform.name`	`string`	Yes	—	Stable machine name (e.g. ‘spotify’, ‘youtube’, ‘twitter’). Suitable for filtering or routing on the client.
`result.data.external_links[].platform.type`	`"podcast_directory" \| "music_service" \| "social_profile" \| "video_channel" \| "community" \| "website" \| "other"`	Yes	—	Broad category for the platform. Use this to group presences in a UI rather than enumerating every Name. Allowed: `podcast_directory`, `music_service`, `social_profile`, `video_channel`, `community`, `website`, `other`.
`result.data.external_links[].url`	`string`	No	—	Resolved web URL for this presence. Built from the identifier via a per-platform template, or passed through for ‘website’.
`result.data.id`	`string`	Yes	—	Unique identifier
`result.data.identifiers`	`object`	No	—	—
`result.data.identifiers.cik`	`string`	No	—	SEC Central Index Key
`result.data.identifiers.domain`	`string`	No	—	Company domain
`result.data.identifiers.entity`	`object`	No	—	—
`result.data.identifiers.entity.company`	`object`	No	—	—
`result.data.identifiers.entity.company.domain`	`string`	No	—	Company website domain
`result.data.identifiers.entity.company.id`	`string`	Yes	—	Company identifier
`result.data.identifiers.entity.company.ticker`	`string`	No	—	Primary stock ticker symbol
`result.data.identifiers.entity.description`	`string`	No	—	Short description
`result.data.identifiers.entity.id`	`string`	Yes	—	Entity ID
`result.data.identifiers.entity.image_url`	`string`	No	—	Entity image URL
`result.data.identifiers.entity.name`	`string`	Yes	—	Entity name
`result.data.identifiers.entity.person`	`object`	No	—	—
`result.data.identifiers.entity.person.company`	`string`	No	—	Current company name
`result.data.identifiers.entity.person.id`	`string`	Yes	—	Person identifier
`result.data.identifiers.entity.person.image_url`	`string`	No	—	Person headshot URL
`result.data.identifiers.entity.person.title`	`string`	No	—	Current role title
`result.data.identifiers.entity.slug`	`string`	Yes	—	Human-readable slug identifier
`result.data.identifiers.entity.type`	`object`	No	—	—
`result.data.identifiers.entity.type.name`	`string`	Yes	—	Human-friendly display label (e.g. ‘Company’).
`result.data.identifiers.entity.type.slug`	`string`	Yes	—	Stable identifier, safe to pass to the type query parameter (e.g. ‘company’).
`result.data.identifiers.entity.wikipedia_url`	`string`	No	—	Wikipedia URL
`result.data.identifiers.qid`	`string`	No	—	Wikidata QID
`result.data.identifiers.ticker`	`string`	No	—	Primary stock ticker symbol
`result.data.image_url`	`string`	No	—	Company logo or image URL, when available.
`result.data.name`	`string`	Yes	—	Company name
`result.data.slug`	`string`	No	—	Stable human-readable handle (the linked knowledge-graph slug, e.g. ‘nvidia’), when known. Companies have no slug of their own. prefer this for display and pass it (or id) to /v1/companies.
`result.data.updated_at`	`string`	No	—	Last updated timestamp Format: `date-time`.
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation