Get a LinkedIn company page

Try in Playground

Retrieve a public company, school or showcase page with identity, description, locations, counts, website, images, specialties, related companies and a page of posts with its continuation token.

GET/v1/linkedin/companyx-api-key

Headers

Get your API key

x-api-keystringrequiredheader

Your ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.

Query parameters

urlstringrequiredquery

Canonical LinkedIn URL from structured data, possibly on a regional host.

min 1 chars · max 500 chars

Examplehttps://www.linkedin.com/company/shopify

Response fields

requestIdstring

Operational correlation UUID.

Upstream attempts (including proxy retries), decoded success-body bytes and duration.

accounting.upstreamRequestsinteger

Always included.

≥ 0

accounting.responseBytesinteger

Always included.

≥ 0

accounting.durationMsnumber

Always included.

≥ 0

successboolean

True when usable data is returned.

statusenum

success or partial; failed/challenged on errors.

one of: success, partial

sourceUrlstring

Canonical www.linkedin.com page read.

absolute HTTPS URL

fetchedAtstring

UTC retrieval time.

Source is always public_page.

coverage.sourceenum

Always included.

one of: public_page, web_search

coverage.completeboolean

Always included.

coverage.warningsstring[]

Always included.

idstringnullable

Numeric organization id from the page, or null.

namestring

Company name.

urlstringnullable

Canonical LinkedIn URL from structured data, possibly on a regional host.

handlestring

Slug taken from the requested URL.

descriptionstringnullable

About text or null.

locationobject

city, state and country from the structured address; keys are present only when published.

followersnumbernullable

Follower count shown in the top card, or null.

employeeCountnumbernullable

Employee count from structured data, or null.

websitestringnullable

Company website or null.

logostringnullable

Logo URL or null.

coverImagestringnullable

Cover image URL or null.

sloganstringnullable

Tagline or null.

similarPagesobject[]

Similar pages with link, name and image.

up to 100 items

industrystringnullable

Industry from the about section, or null.

sizestringnullable

Company size bucket, or null.

foundednumbernullable

Founding year as a number, or null.

headquartersstringnullable

Headquarters string, or null.

typestringnullable

Organization type, or null.

specialtiesstring[]

Specialties split on commas; a single empty string when none are published.

fundingobject

Stable shape with null/empty values; public pages no longer embed funding rounds.

employeesobject[]

Employees shown on the page with name, title (empty on current pages), link and image.

up to 100 items

postsobject[]

First page of company posts: url, id, datePublished and text.

up to 100 items

paginationTokenstringnullable

Guest-feed token embedded in the page; it changes on every fetch.

HTTP 200 returns the success variant. Check status: partial means usable data with warnings, and failed or challenged requests carry a failure object described in Errors & responses.

Error codes

HTTP	failure.code	Meaning
400	`invalid_request`	Not a public LinkedIn profile, company or post URL, or invalid parameters.
401	`unauthorized`	Invalid worker key.
403	`restricted`	LinkedIn redirected to a login page for this resource.
404	`not_found`	The page does not exist or the search returned no posts.
429	`upstream_rate_limited`	LinkedIn or the search index throttled retrieval.
502	`upstream_challenged`	LinkedIn answered with a challenge (HTTP 999/403 or an auth wall), including through the proxy.
502	`upstream_error` `unsupported_page` `unsafe_redirect` `search_failed`	Source or search index did not return a usable page.
503	`search_unavailable` `busy`	No search key configured, or all retrieval slots are busy.
504	`timeout`	The operation exceeded its deadline.

Code example

curl "https://api.scrapeatlas.com/v1/linkedin/company?url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fshopify" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/linkedin/company?url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fshopify",
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(data.status, data);

type Result = {
  status: "success" | "partial" | "failed" | "challenged";
  requestId: string;
  [field: string]: unknown;
};

const response = await fetch(
  "https://api.scrapeatlas.com/v1/linkedin/company?url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fshopify",
  {
    headers: {
      "x-api-key": process.env.SCRAPEATLAS_API_KEY!
    }
  }
);

const data = (await response.json()) as Result;
if (data.status === "failed" || data.status === "challenged") {
  throw new Error(`LinkedIn request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/linkedin/company",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "url": "https://www.linkedin.com/company/shopify"
    },
    timeout=60,
)
data = response.json()
print(data["status"], data)

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.scrapeatlas.com/v1/linkedin/company?url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fshopify", nil)
	req.Header.Set("x-api-key", "YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data["status"], data)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.scrapeatlas.com/v1/linkedin/company?url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fshopify"))
            .GET()
            .header("x-api-key", "YOUR_API_KEY")
            .build();
        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Use your sa_live_… customer key at https://api.scrapeatlas.com.

Responses

Successful result. Synthetic example validated against the runtime contract.

{
  "success": true,
  "status": "success",
  "requestId": "00000000-0000-4000-8000-000000000002",
  "sourceUrl": "https://www.linkedin.com/company/example-co",
  "fetchedAt": "2026-09-11T00:00:00.000Z",
  "coverage": {
    "source": "public_page",
    "complete": true,
    "warnings": []
  },
  "accounting": {
    "upstreamRequests": 1,
    "responseBytes": 350000,
    "durationMs": 1600
  },
  "id": "784652",
  "name": "Example Co",
  "url": "https://ca.linkedin.com/company/example-co",
  "handle": "example-co",
  "description": "Example Co builds examples.",
  "location": {
    "city": "Ottawa",
    "state": "ON",
    "country": "CA"
  },
  "followers": 1107054,
  "employeeCount": 29884,
  "website": "https://www.example.test",
  "logo": "https://media.licdn.com/dms/image/v2/example/company-logo_200_200",
  "coverImage": "https://media.licdn.com/dms/image/v2/example/image-scale_191_1128",
  "slogan": "Make examples better",
  "similarPages": [
    {
      "link": "https://se.linkedin.com/company/similar-co",
      "name": "Similar Co",
      "image": "https://media.licdn.com/dms/image/v2/example/company-logo_100_100"
    }
  ],
  "industry": "Software Development",
  "size": "10,001+ employees",
  "founded": 2006,
  "headquarters": "Ottawa, ON",
  "type": "Public Company",
  "specialties": [
    "ecommerce",
    "API",
    "and Shipping"
  ],
  "funding": {
    "numberOfRounds": null,
    "lastRound": {
      "type": "",
      "date": null,
      "amount": ""
    },
    "investors": []
  },
  "employees": [
    {
      "name": "Employee One",
      "title": "",
      "link": "https://www.linkedin.com/in/employee-one",
      "image": "https://media.licdn.com/dms/image/v2/example/profile-displayphoto-shrink_100_100"
    }
  ],
  "posts": [
    {
      "url": "https://www.linkedin.com/posts/example-co_first-activity-7503174385890013184-SFku",
      "id": "7503174385890013184",
      "datePublished": "2026-09-08T19:36:15.732Z",
      "text": "First company post."
    }
  ],
  "paginationToken": "0-1789118187612-53482c03d7dcb89416b7057d9e580035"
}

Not a public LinkedIn profile, company or post URL, or invalid parameters.

{
  "requestId": "9d2f1c0a-6b1e-4c7d-9a8e-2f3b4c5d6e7f",
  "accounting": {
    "upstreamRequests": 0,
    "responseBytes": 0,
    "durationMs": 0
  },
  "success": false,
  "status": "failed",
  "failure": {
    "code": "invalid_request",
    "message": "Invalid request: missing, duplicate, unsupported or malformed parameters."
  }
}