Company Enrichment

cURL

curl --request GET \
  --url https://api.firmable.com/company \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.firmable.com/company', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.firmable.com/company",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.firmable.com/company"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.firmable.com/company")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "f0000067890",
  "name": "The name of the company.",
  "website": "https://www.example.com",
  "fqdn": "firmable.com",
  "description": "CommBank offers personal banking, business solutions, institutional banking, company information, and more",
  "tagline": "We are a team of 1000 people",
  "linkedin": "commbank",
  "employee_count": 1000,
  "year_founded": 2000,
  "hq_location": "Wallan",
  "hq_country": "Australia",
  "company_size": "1000+",
  "company_type": "Public company",
  "abn_operation_status": "active",
  "locations": [
    "Sydney",
    "Melbourne"
  ],
  "industries": [
    "Finance",
    "Tech"
  ],
  "revenue": ">$1B+",
  "phones": [
    "0450 600 0000"
  ],
  "emails": [
    "email@example.com"
  ],
  "social_media": {
    "twitter": "username",
    "youtube": "username",
    "facebook": "username",
    "linkedin": "username",
    "instagram": "username"
  },
  "industry_codes": {
    "sic": "1234567890",
    "duns": "1234567890",
    "naics": "1234567890",
    "anzsic": "1234567890",
    "abn": "47065475149",
    "acn": "123456789",
    "nzbn": "9429000000000",
    "uen": "202300001A"
  },
  "keywords": [
    "Finance",
    "Tech"
  ],
  "org_registers": {
    "vc": "VCs & Investors"
  },
  "states": [
    "NSW",
    "VIC"
  ],
  "nextGen": {
    "website": "https://www.example.com",
    "social_media": {
      "youtube": {
        "profile_name": "profile_name",
        "handle": "handle",
        "followers": 100,
        "verified": true,
        "videos": 100,
        "likes": 100,
        "views": 100,
        "subscribers": 100,
        "following": 100,
        "joined": "2021-01-01"
      },
      "instagram": {
        "profile_name": "profile_name",
        "handle": "handle",
        "followers": 100,
        "verified": true,
        "videos": 100,
        "likes": 100,
        "views": 100,
        "subscribers": 100,
        "following": 100,
        "joined": "2021-01-01"
      },
      "linkedin": {
        "profile_name": "profile_name",
        "handle": "handle",
        "followers": 100,
        "verified": true,
        "videos": 100,
        "likes": 100,
        "views": 100,
        "subscribers": 100,
        "following": 100,
        "joined": "2021-01-01"
      },
      "facebook": {
        "profile_name": "profile_name",
        "handle": "handle",
        "followers": 100,
        "verified": true,
        "videos": 100,
        "likes": 100,
        "views": 100,
        "subscribers": 100,
        "following": 100,
        "joined": "2021-01-01"
      }
    },
    "reviews_rating": {
      "ceo_approval": "4.5",
      "total_reviews": 100,
      "rating": {
        "ceo_approval_rating": "4.5",
        "career_opportunities_rating": "4.5",
        "compensation_and_benefits_rating": "4.5",
        "culture_and_values_rating": "4.5",
        "diversity_and_inclusion_rating": "4.5",
        "senior_management_rating": "4.5",
        "work_life_balance_rating": "4.5"
      },
      "overall_rating": "4.5",
      "employee_rating_id": "fp000000067890",
      "recommend_to_friend": 232,
      "url": 4.5
    },
    "id": "f0000067890",
    "web_traffic": {
      "summary": {
        "avg_visit_duration": "<string>",
        "total_web_visitors": 123,
        "bounce_rate": 123,
        "pages_per_visit": 123
      },
      "traffic_share": {
        "countries": {},
        "organic": 123,
        "paid": 123
      },
      "marketing_channels_distribution": {
        "Direct": 123,
        "Referrals": 123,
        "Search": 123,
        "Social": 123,
        "Mail": 123
      }
    }
  }
}

{
  "error": 123,
  "message": "<string>"
}

GET

company

cURL

curl --request GET \
  --url https://api.firmable.com/company \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.firmable.com/company', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.firmable.com/company",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.firmable.com/company"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.firmable.com/company")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "f0000067890",
  "name": "The name of the company.",
  "website": "https://www.example.com",
  "fqdn": "firmable.com",
  "description": "CommBank offers personal banking, business solutions, institutional banking, company information, and more",
  "tagline": "We are a team of 1000 people",
  "linkedin": "commbank",
  "employee_count": 1000,
  "year_founded": 2000,
  "hq_location": "Wallan",
  "hq_country": "Australia",
  "company_size": "1000+",
  "company_type": "Public company",
  "abn_operation_status": "active",
  "locations": [
    "Sydney",
    "Melbourne"
  ],
  "industries": [
    "Finance",
    "Tech"
  ],
  "revenue": ">$1B+",
  "phones": [
    "0450 600 0000"
  ],
  "emails": [
    "email@example.com"
  ],
  "social_media": {
    "twitter": "username",
    "youtube": "username",
    "facebook": "username",
    "linkedin": "username",
    "instagram": "username"
  },
  "industry_codes": {
    "sic": "1234567890",
    "duns": "1234567890",
    "naics": "1234567890",
    "anzsic": "1234567890",
    "abn": "47065475149",
    "acn": "123456789",
    "nzbn": "9429000000000",
    "uen": "202300001A"
  },
  "keywords": [
    "Finance",
    "Tech"
  ],
  "org_registers": {
    "vc": "VCs & Investors"
  },
  "states": [
    "NSW",
    "VIC"
  ],
  "nextGen": {
    "website": "https://www.example.com",
    "social_media": {
      "youtube": {
        "profile_name": "profile_name",
        "handle": "handle",
        "followers": 100,
        "verified": true,
        "videos": 100,
        "likes": 100,
        "views": 100,
        "subscribers": 100,
        "following": 100,
        "joined": "2021-01-01"
      },
      "instagram": {
        "profile_name": "profile_name",
        "handle": "handle",
        "followers": 100,
        "verified": true,
        "videos": 100,
        "likes": 100,
        "views": 100,
        "subscribers": 100,
        "following": 100,
        "joined": "2021-01-01"
      },
      "linkedin": {
        "profile_name": "profile_name",
        "handle": "handle",
        "followers": 100,
        "verified": true,
        "videos": 100,
        "likes": 100,
        "views": 100,
        "subscribers": 100,
        "following": 100,
        "joined": "2021-01-01"
      },
      "facebook": {
        "profile_name": "profile_name",
        "handle": "handle",
        "followers": 100,
        "verified": true,
        "videos": 100,
        "likes": 100,
        "views": 100,
        "subscribers": 100,
        "following": 100,
        "joined": "2021-01-01"
      }
    },
    "reviews_rating": {
      "ceo_approval": "4.5",
      "total_reviews": 100,
      "rating": {
        "ceo_approval_rating": "4.5",
        "career_opportunities_rating": "4.5",
        "compensation_and_benefits_rating": "4.5",
        "culture_and_values_rating": "4.5",
        "diversity_and_inclusion_rating": "4.5",
        "senior_management_rating": "4.5",
        "work_life_balance_rating": "4.5"
      },
      "overall_rating": "4.5",
      "employee_rating_id": "fp000000067890",
      "recommend_to_friend": 232,
      "url": 4.5
    },
    "id": "f0000067890",
    "web_traffic": {
      "summary": {
        "avg_visit_duration": "<string>",
        "total_web_visitors": 123,
        "bounce_rate": 123,
        "pages_per_visit": 123
      },
      "traffic_share": {
        "countries": {},
        "organic": 123,
        "paid": 123
      },
      "marketing_channels_distribution": {
        "Direct": 123,
        "Referrals": 123,
        "Search": 123,
        "Social": 123,
        "Mail": 123
      }
    }
  }
}

{
  "error": 123,
  "message": "<string>"
}

Description

Look up a company profile by Firmable ID, LinkedIn slug, LinkedIn URL, FQDN, ABN, or website. Use the optional country query param to return region-specific data. Supported country codes: AU, NZ, SG, MY, ID, PH, HK, JP, VN, KR, TH, US, CA. Defaults to AU when not provided. Returns a 400 error for unsupported country codes.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

string

The Firmable ID of the company (example: f000000117274)

ln_slug

string

The LinkedIn slug of the company (example: smec)

ln_url

string

LinkedIn URL of the company (example: https://www.linkedin.com/company/smec/)

fqdn

string

FQDN of the company (example: smec.com)

abn

string

ABN of the company (example: 47065475149)

website

string

Website of the company (example: https://www.smec.com)

country

enum<string>

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.

Available options:

AU,

NZ,

SG,

MY,

ID,

PH,

HK,

JP,

VN,

KR,

TH,

US,

CA

Response

Company response

string

The Firmable ID of the company.

Example:

"f0000067890"

name

string

The name of the company.

Example:

"The name of the company."

website

string

The company's website URL.

Example:

"https://www.example.com"

fqdn

string

The fully qualified domain name of the company's website.

Example:

"firmable.com"

description

string

A detailed description of the company.

Example:

"CommBank offers personal banking, business solutions, institutional banking, company information, and more"

tagline

string

A brief tagline or slogan for the company.

Example:

"We are a team of 1000 people"

string

The company's LinkedIn handle.

Example:

"commbank"

employee_count

integer | null

The number of employees in the requested country region.

Example:

1000

year_founded

integer

The year the company was founded.

Example:

2000

hq_location

string | null

The headquarters location of the company.

Example:

"Wallan"

hq_country

string

The country of the company's headquarters.

Example:

"Australia"

company_size

string

The size category of the company.

Example:

"1000+"

company_type

string

The type of company (e.g., Private, Public).

Example:

"Public company"

abn_operation_status

string

The operational status of the company's ABN.

Example:

"active"

locations

string[]

The locations associated with the company.

Example:

["Sydney", "Melbourne"]

industries

string[]

The industries associated with the company.

Example:

["Finance", "Tech"]

revenue

string

The company's revenue, if available.

Example:

">$1B+"

phones

string[]

List of phone numbers associated with the company.

Example:

["0450 600 0000"]

emails

string[]

List of email addresses associated with the company.

Example:

["email@example.com"]

Social media profiles of the company.

Show child attributes

industry_codes

object

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).

Show child attributes

keywords

string[]

Keywords associated with the company.

Example:

["Finance", "Tech"]

org_registers

object

Information about organizational registers.

Example:

{ "vc": "VCs & Investors" }

states

string[]

Additional state information about the company.

Example:

["NSW", "VIC"]

nextGen

object

Next-generation data about the company.

Show child attributes

Overview

Enrichment APIs

Tech Intelligence API

Company Enrichment

Description

Authorizations

Query Parameters

Response