Firmable: Company Lookup

Get a company’s profile from its LinkedIn URL, website, domain or Australian Business Number.

Tool ID: firmable_company_lookup

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(
  'firmable_company_lookup',
  {
    "id": "id_123"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute firmable_company_lookup --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",
    "website": "https://example.com"
  }
}

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

Input reference

Returns company information

Name	Type	Required	Default	Details
`payload.id`	`string`	No	—	The Firmable ID of the company (example: f000000117274)
`payload.ln_slug`	`string`	No	—	The LinkedIn slug of the company (example: smec)
`payload.ln_url`	`string`	No	—	LinkedIn URL of the company (example: https://www.linkedin.com/company/smec/)
`payload.fqdn`	`string`	No	—	FQDN of the company (example: smec.com)
`payload.abn`	`string`	No	—	ABN of the company (example: 47065475149)
`payload.website`	`string`	No	—	Website of the company (example: https://www.smec.com)
`payload.country`	`"AU" \| "NZ" \| "SG" \| "MY" \| "ID" \| "PH" \| "HK" \| "JP" \| "VN" \| "KR" \| "TH" \| "US" \| "CA"`	No	—	ISO country code to return region-specific data for. Supported values: AU, NZ, SG, MY, ID, PH, HK, JP, VN, KR, TH, US, CA. Defaults to AU when not provided. Allowed: `AU`, `NZ`, `SG`, `MY`, `ID`, `PH`, `HK`, `JP`, `VN`, `KR`, `TH`, `US`, `CA`.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.id`	`string`	No	—	The Firmable ID of the company.
`result.data.name`	`string`	No	—	The name of the company.
`result.data.website`	`string`	No	—	The company’s website URL.
`result.data.fqdn`	`string`	No	—	The fully qualified domain name of the company’s website.
`result.data.description`	`string`	No	—	A detailed description of the company.
`result.data.tagline`	`string`	No	—	A brief tagline or slogan for the company.
`result.data.linkedin`	`string`	No	—	The company’s LinkedIn handle.
`result.data.employee_count`	`integer \| null`	No	—	The number of employees in the requested country region.
`result.data.year_founded`	`integer`	No	—	The year the company was founded.
`result.data.hq_location`	`string \| null`	No	—	The headquarters location of the company.
`result.data.hq_country`	`string`	No	—	The country of the company’s headquarters.
`result.data.company_size`	`string`	No	—	The size category of the company.
`result.data.company_type`	`string`	No	—	The type of company (e.g., Private, Public).
`result.data.abn_operation_status`	`string`	No	—	The operational status of the company’s ABN.
`result.data.locations`	`array`	No	—	The locations associated with the company.
`result.data.industries`	`array`	No	—	The industries associated with the company.
`result.data.revenue`	`string`	No	—	The company’s revenue, if available.
`result.data.phones`	`array`	No	—	List of phone numbers associated with the company.
`result.data.emails`	`array`	No	—	List of email addresses associated with the company.
`result.data.social_media`	`object`	No	—	Social media profiles of the company.
`result.data.social_media.twitter`	`string \| null`	No	—	Twitter handle of the company.
`result.data.social_media.youtube`	`string \| null`	No	—	Youtube channel of the company.
`result.data.social_media.facebook`	`string \| null`	No	—	Facebook page of the company.
`result.data.social_media.linkedin`	`string \| null`	No	—	LinkedIn profile of the company.
`result.data.social_media.instagram`	`string \| null`	No	—	Instagram handle of the company.
`result.data.industry_codes`	`object`	No	—	Industry classification and business identifier codes for the company. Always includes global codes (sic, duns, naics, anzsic) where available. Also includes country-specific business identifiers depending on the requested region — for example: abn and acn for AU, nzbn for NZ, uen for SG. Additional identifiers may be present for other supported countries (MY, ID, PH, HK, JP, VN, KR, TH, US, CA).
`result.data.industry_codes.sic`	`string \| null`	No	—	Standard Industrial Classification code.
`result.data.industry_codes.duns`	`string \| null`	No	—	Data Universal Numbering System number.
`result.data.industry_codes.naics`	`string \| null`	No	—	North American Industry Classification System code.
`result.data.industry_codes.anzsic`	`string \| null`	No	—	Australian and New Zealand Standard Industrial Classification code.
`result.data.industry_codes.abn`	`string \| null`	No	—	Australian Business Number (AU only).
`result.data.industry_codes.acn`	`string \| null`	No	—	Australian Company Number (AU only).
`result.data.industry_codes.nzbn`	`string \| null`	No	—	New Zealand Business Number (NZ only).
`result.data.industry_codes.uen`	`string \| null`	No	—	Unique Entity Number (SG only).
`result.data.keywords`	`array`	No	—	Keywords associated with the company.
`result.data.org_registers`	`record`	No	—	Information about organizational registers.
`result.data.states`	`array`	No	—	Additional state information about the company.
`result.data.nextGen`	`object`	No	—	Next-generation data about the company.
`result.data.nextGen.technographics`	`record`	No	—	Technographics profile of the company.
`result.data.nextGen.website`	`string`	No	—	The company’s website URL.
`result.data.nextGen.social_media`	`object`	No	—	Detailed social media information.
`result.data.nextGen.social_media.youtube`	`object`	No	—	YouTube channel details.
`result.data.nextGen.social_media.youtube.profile_name`	`string`	No	—	—
`result.data.nextGen.social_media.youtube.handle`	`string`	No	—	—
`result.data.nextGen.social_media.youtube.followers`	`integer \| null`	No	—	—
`result.data.nextGen.social_media.youtube.verified`	`string \| null`	No	—	—
`result.data.nextGen.social_media.youtube.videos`	`integer \| null`	No	—	—
`result.data.nextGen.social_media.youtube.likes`	`integer \| null`	No	—	—
`result.data.nextGen.social_media.youtube.views`	`integer \| null`	No	—	—

The table shows the first 50 fields. Expand the raw schema below for every field.

This output schema is too large for an inline display. Read the complete live contract with deepline describe firmable_company_lookup --json.

Deepline cost

Pricing model: per_result (per result).
Estimated Deepline credits: 3.57 per pricing unit.

​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