Name: LinkedIn Data API - Public Profile, Company & Job Metadata
Brand: sitetrace
SKU: api-sitetrace-linkedin-data
Availability: InStock
Author: API Market

Edy Appenzeller

# LinkedIn Data API - Public Profile, Company, and Job Metadata

The LinkedIn Data API extracts structured metadata from publicly accessible LinkedIn URLs. It is built for teams that need clean JSON from public profile pages, company pages, and job postings without building their own metadata parser. Common use cases include CRM enrichment, lead research, recruiting operations, sales intelligence workflows, account research, public company monitoring, and market research dashboards.

This API focuses on information that is already visible in public page markup. It looks for schema.org JSON-LD, Open Graph tags, canonical links, page titles, descriptions, image metadata, organization hints, job posting hints, and other public signals returned by the target page. It does not log in to LinkedIn, does not use user credentials, does not bypass access controls, and does not access private member information. If a page is not publicly available, the response may contain fewer fields or return an error.

## Endpoint

`POST https://prod.api.market/v1/sitetrace/linkedin-data/api/linkedin-data`

Use the endpoint shown in your api.market subscription dashboard. Authentication, quota enforcement, plan limits, usage tracking, and billing are handled by api.market.

## Request Body

```json
{
  "url": "https://www.linkedin.com/company/microsoft/"
}
```

The `url` field is required. Send a complete public LinkedIn URL. The API supports company pages, public profile pages, and job posting pages when their metadata is available without a login. The URL should include the `https://www.linkedin.com/` host and the full path for the page you want to analyze.

## cURL Example

```bash
curl -X POST "https://prod.api.market/v1/sitetrace/linkedin-data/api/linkedin-data" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{"url":"https://www.linkedin.com/company/microsoft/"}'
```

## JavaScript Example

```javascript
const response = await fetch("https://prod.api.market/v1/sitetrace/linkedin-data/api/linkedin-data", {
  method: "POST",
  headers: {"Content-Type": "application/json", "x-api-market-key": "YOUR_API_MARKET_KEY"},
  body: JSON.stringify({url: "https://www.linkedin.com/company/microsoft/"})
});
console.log(await response.json());
```

## Python Example

```python
import requests
response = requests.post(
    "https://prod.api.market/v1/sitetrace/linkedin-data/api/linkedin-data",
    headers={"Content-Type": "application/json", "x-api-market-key": "YOUR_API_MARKET_KEY"},
    json={"url": "https://www.linkedin.com/company/microsoft/"},
    timeout=30
)
print(response.json())
```

## Successful Response Example

```json
{
  "success": true,
  "data": {
    "url": "https://www.linkedin.com/company/microsoft/",
    "page_type": "company",
    "name": "Microsoft",
    "headline": "Software Development",
    "description": "Public company description detected from page metadata.",
    "location": "Redmond, Washington",
    "website": "https://www.microsoft.com",
    "logo": "https://media.licdn.com/...",
    "metadata": {
      "og_title": "Microsoft | LinkedIn",
      "canonical": "https://www.linkedin.com/company/microsoft/"
    },
    "plan": "pro"
  }
}
```

## Supported Page Types

Company pages can return organization name, description, category or industry signals, public website, location signals, logo, canonical URL, social metadata, and public page identifiers when available.

Public profile pages can return visible name, headline, location, profile image, canonical URL, and public metadata when available. Some profile pages expose limited information unless the viewer is logged in, so responses for profile URLs may be intentionally sparse.

Job posting pages can return job title, hiring company, location, employment type, description snippet, posting metadata, canonical URL, and other public job details when available in markup.

## Common Use Cases

Use this API to enrich CRM records with public LinkedIn company metadata. A sales or operations team can submit a company LinkedIn URL and store normalized organization data alongside account records.

Use it to validate and normalize public LinkedIn URLs submitted by users. Instead of storing only raw URLs, your application can capture canonical links, names, page titles, and descriptions.

Use it in recruiting workflows to summarize public job posting metadata. A recruiting dashboard can combine job title, hiring company, location, and description snippets with internal candidate or sourcing data.

Use it in market research workflows to monitor public profile or company page metadata over time. When the same URL is checked periodically, changes in title, description, logo, or canonical URL can become useful signals.

Use it with Company Intelligence, Email Finder, Business Lead Score, or other SiteTrace APIs to build a fuller account research workflow. LinkedIn metadata can provide social context while company intelligence endpoints provide website, technology, page, and business signals.

## Limitations and Expected Behavior

The API only reads public page markup. If a LinkedIn page requires login, blocks automated access, hides metadata, or returns limited public content, the response may contain fewer fields than the examples above.

LinkedIn controls what is publicly visible. This API cannot guarantee complete data for every URL and cannot return private information that is not present in the public response.

The API does not use credentials, does not access authenticated sessions, and does not bypass robots, paywalls, login walls, or access controls. It should be used for public metadata enrichment and public-page analysis only.

Some URLs may return temporary network errors, timeouts, or target unavailable errors. In those cases, retry later or test the URL in a normal browser to confirm whether the page is publicly accessible.

## Error Examples

Missing URL:
```json
{"success": false, "error": "url is required"}
```

Unsupported or private URL:
```json
{"success": false, "error": "Private/local network URLs are not supported"}
```

Target unavailable:
```json
{"success": false, "error": "Failed to fetch or analyze URL"}
```

## Best Practices

Use full public URLs with `https://www.linkedin.com/...`.

Prefer company pages and job postings that can be opened without logging in.

Cache results on your side when monitoring the same URL repeatedly.

Store the original URL and timestamp with each response so your application can trace where the metadata came from.

Handle optional fields gracefully. Not every LinkedIn page exposes the same public metadata.

Validate user-submitted URLs before sending them to the API. The endpoint is intended for public LinkedIn pages and should not be used with private network URLs, local URLs, or unrelated domains.

Respect applicable laws, platform terms, and privacy expectations in your own application. This API is intended for public metadata extraction, enrichment, and analysis workflows.

## Implementation Notes

For best results, submit one URL per request. If you are processing many records, queue requests and store completed responses in your own database. This makes your application faster, reduces duplicate calls, and helps you stay within your selected api.market plan limits.

If your workflow depends on specific fields, build fallback handling. For example, if `website` is missing from a LinkedIn company page response, you can pass the company name or domain to Company Intelligence to collect additional public business context.

When displaying results to users, show that the data comes from public LinkedIn metadata and may vary by page availability. This makes the output easier to understand when some pages return rich company information and others return only title, canonical URL, and description.

Extract structured public LinkedIn metadata for profiles, company pages, and job postings. JSON output for CRM enrichment, recruiting, sales intelligence, and market research.

LinkedIn Data API - Public Profile, Company & Job Metadata

Basic