Skip to main content

LinkedIn API Overview

LinkedIn scraping is notoriously hard - anti-bot systems, frequent changes, and rate limits make traditional scrapers unreliable and expensive. WraithBytes solves this with isolated execution environments and modern engineering: Each request runs in a fresh serverless function built with low-level, type-safe programming languages. This architecture eliminates shared state, enables instant horizontal scaling, and catches bugs at compile time rather than runtime. The result? Blazing-fast 3-8 second response times, rock-solid reliability through static type safety, unlimited concurrency, and $0.0007 per successful request pricing.

Technical Overview

Available Endpoints

Profile Endpoint

  • Method: POST
  • Path: /api/v1/scraper/linkedin/profile
  • Input: LinkedIn profile URL
  • Output: JSON with personal info, experience, education, skills, contact data
  • Avg Response Time: 3-8 seconds
  • Response Size: ~10-50KB
Profile Documentation → | Profile API Reference →

Company Endpoint

  • Method: POST
  • Path: /api/v1/scraper/linkedin/company
  • Input: LinkedIn company page URL
  • Output: JSON with company info, industry, size, locations
  • Avg Response Time: 3-8 seconds
  • Response Size: ~5-20KB
Company Documentation → | Company API Reference →

Authentication

All endpoints require Bearer token authentication:
Authorization: Bearer YOUR_API_KEY

Rate Limits

No rate limits - unlimited concurrent requests supported. Scale your scraping operations without throttling or queue delays.

Response Format

All endpoints return JSON with:
  • Success (200): Scraped data object
  • Error (4xx/5xx): {"error": "message"} object

Data Characteristics

Encoding

  • UTF-8 for all text fields
  • Supports international characters

Timestamps

  • Format: ISO 8601 (YYYY-MM-DDTHH:mm:ssZ)
  • Timezone: UTC

Date Fields

  • Profile/Company dates: YYYY-MM or YYYY format
  • Metadata timestamps: ISO 8601

Nullability

  • Most fields can be null if not present on LinkedIn
  • Always present: id, url, scraped_at, created_at

Pricing

Pay per request: 0.0007persuccessfulrequest(0.0007 per successful request (0.7 per 1,000 requests)
  • No subscriptions
  • No hidden fees
  • No pricing tiers
  • Charged only on successful scrapes

Error Codes

CodeDescription
400Invalid URL format or missing parameters
401Invalid or missing API key
500Scraping failed (LinkedIn unavailable, profile not found, etc.)

Data Freshness

  • Data is scraped on-demand (real-time)
  • scraped_at timestamp indicates when data was retrieved
  • LinkedIn profiles/companies update at user discretion
  • Recommend re-scraping periodically for current data

Technical Notes

  • Concurrency: Unlimited concurrent requests
  • Async Processing: Not supported; all requests are synchronous
  • Batch Requests: Not supported; one URL per request
  • Webhooks: Not available
  • Caching: No built-in caching; implement client-side if needed