Skip to main content

​
Overview

Extracts structured company data from LinkedIn company pages. Returns organizational information, industry classification, size metrics, and locations. Output can be structured JSON or Markdown depending on your fetch options.

​
Request

Send a LinkedIn company URL to the universal fetch endpoint: 
curl -X POST https://web-acq.wraithbytes.com/api/v1/internet/fetch/ \
  -H "Authorization: Bearer $WRAITHBYTES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.linkedin.com/company/company-name"}'
​
url
string
required
The LinkedIn company URL.Example: https://www.linkedin.com/company/company-name

​
Response Fields

​
Basic Information

​
id
integer
Unique identifier for the record
​
url
string
The LinkedIn company URL. Format: https://www.linkedin.com/company/{company-slug}
​
name
string
Official company name as displayed on LinkedIn. May include legal suffixes (Inc., LLC, Ltd., etc.). UTF-8 encoded.

​
Classification

​
industry
string
Primary industry category from LinkedIn’s predefined taxonomy. Examples: “Information Technology and Services”, “Financial Services”, “Computer Software”.
​
type
string
Organizational structure type. Possible values: “Public Company”, “Privately Held”, “Non-profit”, “Partnership”, “Educational Institution”, “Government Agency”, “Self-Employed”.

​
Size & Scale

​
company_size
string
Employee count range. Format: {min}-{max} employees. Standard ranges: “1-10”, “11-50”, “51-200”, “201-500”, “501-1000”, “1001-5000”, “5001-10000”, “10001+”. Self-reported by company admin.
​
employee_count
integer
Approximate employee count calculated by LinkedIn based on member profiles listing this company. More dynamic and generally more accurate than company_size.

​
Location

​
headquarters
string
Primary office location. Format: “City, State/Region” or “City, Country”.
​
locations
array
Additional office locations (array of strings). May include headquarters. Format same as headquarters field.

​
Temporal

​
founded
string
Year company was founded. Format: “YYYY”. May be null if not provided.

​
Business Details

​
specialties
array
Company focus areas and expertise (array of strings). User-defined keywords.
​
about
string
Company description. Free-form text, typically 500-2000 characters. Contains company mission, products, and services.

​
Contact & Web Presence

​
website
string
Primary company website URL including protocol.
​
phone
string
Main company phone number. May be null.
​
linkedin_url
string
LinkedIn company page URL.
​
twitter_url
string
Company Twitter/X profile URL. May be null.
​
facebook_url
string
Company Facebook page URL. May be null.

​
Metadata

​
scraped_at
string
Timestamp of acquisition. Format: ISO 8601 (e.g., “2025-01-10T12:00:00Z”). UTC timezone.
​
created_at
string
Record creation timestamp. Format: ISO 8601. UTC timezone.

​
Data Notes

​
Company Size vs Employee Count

  • company_size: Static range set by admin, may be outdated
  • employee_count: Dynamic count from LinkedIn member data, more current
  • Discrepancies are common; employee_count is generally more accurate for recent data

​
Field Completeness

  • Always present: id, url, name, scraped_at, created_at
  • Usually present: industry, company_size, headquarters
  • Often present: about, website, employee_count
  • Sometimes present: specialties, locations, founded
  • Rarely present: phone, twitter_url, facebook_url

​
Data Accuracy

  • Self-reported by company administrators
  • Not verified by LinkedIn or WraithBytes
  • Update frequency varies by company engagement
  • Social media links may be outdated

​
Response Example

{
  "success": true,
  "status": "success",
  "data": {
    "id": 1,
    "url": "https://www.linkedin.com/company/tech-company",
    "name": "Tech Company Inc.",
    "industry": "Information Technology and Services",
    "company_size": "501-1000 employees",
    "headquarters": "San Francisco, CA",
    "type": "Private",
    "founded": "2015",
    "specialties": [
      "Cloud Computing",
      "Artificial Intelligence",
      "Data Analytics",
      "Software Development"
    ],
    "about": "Tech Company Inc. is a leading provider of cloud-based solutions...",
    "website": "https://www.techcompany.com",
    "phone": "+1-415-555-0100",
    "linkedin_url": "https://www.linkedin.com/company/tech-company",
    "twitter_url": "https://twitter.com/techcompany",
    "facebook_url": "https://facebook.com/techcompany",
    "employee_count": 750,
    "locations": [
      "San Francisco, CA",
      "New York, NY",
      "Austin, TX",
      "London, UK"
    ],
    "scraped_at": "2025-01-10T12:00:00Z",
    "created_at": "2025-01-10T12:00:00Z"
  }
}

​
Technical Specifications

  • Encoding: UTF-8
  • Date Formats: ISO 8601 for timestamps, “YYYY” for founded year
  • Max Response Size: Typically 5-20KB per company
  • Null Values: Most fields can be null if not provided by company