Company Enrichment

GET

company

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

Copy
{
  "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",
  "au_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": {
    "abn": "1234567890",
    "acn": "1234567890",
    "sic": "1234567890",
    "duns": "1234567890",
    "naics": "1234567890",
    "anzsic": "1234567890"
  },
  "keywords": [
    "Finance",
    "Tech"
  ],
  "org_registers": {
    "vc": "VCs & Investors"
  },
  "states": [
    "NSW",
    "VIC"
  ],
  "nextGen": {
    "technographics": {
      "Software Development": [
        "PostgreSQL",
        "Java"
      ],
      "Finance & Accounting": [
        "Visa",
        "Pace"
      ]
    },
    "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
      }
    }
  }
}

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)

Response

200

application/json

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"

au_employee_count

integer | null

The number of employees in Australia.

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.

industry_codes

object

Various industry classification codes for the company.

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.

nextGen.technographics

object

Technographics profile of the company.

Example:

{
  "Software Development": ["PostgreSQL", "Java"],
  "Finance & Accounting": ["Visa", "Pace"]
}

nextGen.website

string

The company's website URL.

Example:

"https://www.example.com"

Detailed social media information.

YouTube channel details.

nextGen.reviews_rating

object | null

Company reviews and ratings.

nextGen.id

string

The Firmable ID of the company (repeated).

Example:

"f0000067890"

nextGen.web_traffic

object

Web traffic data.

Rate Limits People Enrichment

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

Copy
{
  "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",
  "au_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": {
    "abn": "1234567890",
    "acn": "1234567890",
    "sic": "1234567890",
    "duns": "1234567890",
    "naics": "1234567890",
    "anzsic": "1234567890"
  },
  "keywords": [
    "Finance",
    "Tech"
  ],
  "org_registers": {
    "vc": "VCs & Investors"
  },
  "states": [
    "NSW",
    "VIC"
  ],
  "nextGen": {
    "technographics": {
      "Software Development": [
        "PostgreSQL",
        "Java"
      ],
      "Finance & Accounting": [
        "Visa",
        "Pace"
      ]
    },
    "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
      }
    }
  }
}

Overview

Enrichment APIs

Company Enrichment

Authorizations

Query Parameters

Response