​

LinkedIn Profile Documentation

Technical field definitions for LinkedIn profile endpoint.

​

Overview

Extracts structured profile data from LinkedIn URLs. Returns JSON with personal information, work history, education, skills, and contact details.

​

Response Fields

​

Basic Information

id (integer)

• Unique identifier assigned by WraithBytes
• Auto-incremented database primary key
• Use for tracking and referencing scrape records

url (string)

• LinkedIn profile URL that was scraped
• Format: https://www.linkedin.com/in/{username}
• Normalized to canonical form

name (string)

• Full name as displayed on profile
• May include middle names, suffixes, or preferred names
• UTF-8 encoded, supports international characters

headline (string)

• Professional tagline under profile name
• Max ~220 characters (LinkedIn limit)
• User-curated, often includes current role and company

location (string)

• Geographic location from profile
• Format: “City, State” or “City, Country”
• May show “Remote” or regional descriptions

about (string)

• Summary/about section content
• Free-form text, length varies (typically 500-2000 characters)
• May be null if user hasn’t filled this section
• Supports markdown-like formatting in source

​

Experience

experience (array of objects)

• Chronological work history
• Ordered by most recent first (typically)
• Each object contains:
  • company (string): Employer name as listed
  • title (string): Job title/position
  • location (string): Job location (may differ from current location)
  • start_date (string): Start date, format varies (“YYYY-MM” or “YYYY”)
  • end_date (string): End date, empty string if current position
  • description (string): Role description, may be null
  • is_current (boolean): True if currently employed here

​

Education

education (array of objects)

• Educational background
• Each object contains:
  • school (string): Institution name
  • degree (string): Degree type (e.g., “Bachelor of Science”, “MBA”)
  • field_of_study (string): Major/concentration
  • start_date (string): Start year (format: “YYYY”)
  • end_date (string): End year, may be empty if not completed
  • grade (string): GPA or grade, often null
  • description (string): Additional details, may be null

​

Skills

skills (array of strings)

• List of skills added by user
• Unordered
• May include endorsed skills and self-added skills
• No endorsement count data included

​

Contact Information

contact_info (object)

• Contact methods, if publicly available
• Most fields often null (not publicly shared)
• Contains:
  • email (string): Email address, rarely public
  • phone (string): Phone number, rarely public
  • linkedin (string): LinkedIn profile URL
  • twitter (string): Twitter/X handle or URL
  • website (string): Personal website URL
  • other_links (array): Additional social/professional links

​

Metadata

scraped_at (string)

• Timestamp of scrape
• Format: ISO 8601 (e.g., “2025-01-10T12:00:00Z”)
• UTC timezone

created_at (string)

• Record creation timestamp in WraithBytes database
• Format: ISO 8601
• UTC timezone

​

Data Notes

• Completeness: Not all profiles have all fields populated
• Accuracy: Self-reported data, not verified
• Freshness: Point-in-time snapshot, may be outdated
• Privacy: Contact info rarely public; respect user privacy
• Encoding: All text fields are UTF-8
• Nullability: Most string fields can be null or empty

​

Technical Specifications

• Response Format: JSON
• Encoding: UTF-8
• Date Formats: Varies by field (ISO 8601 for timestamps, “YYYY-MM” or “YYYY” for dates)
• Max Response Size: Varies (typically 10-50KB per profile)

View API Reference →