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
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
Authentication
All endpoints require Bearer token authentication: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-MMorYYYYformat - 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.7 per 1,000 requests)- No subscriptions
- No hidden fees
- No pricing tiers
- Charged only on successful scrapes
Error Codes
| Code | Description |
|---|---|
| 400 | Invalid URL format or missing parameters |
| 401 | Invalid or missing API key |
| 500 | Scraping failed (LinkedIn unavailable, profile not found, etc.) |
Data Freshness
- Data is scraped on-demand (real-time)
scraped_attimestamp 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