> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scraperize.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Company
> Fetches a public LinkedIn company page and returns the company profile — name, tagline, about, website, industry, company size, employees, headquarters, founded year, specialties, follower count, and recent posts. Only publicly available data is returned.
**Cost: 1 credit** per successful request. Errors and cache hits (`cache_max_age`) are free.
Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button).
```text Prompt
I want to make an API call to /v1/linkedin/company. Here are the details:
Endpoint: GET https://api.scraperize.com/v1/linkedin/company
Description: Fetches a public LinkedIn company page and returns the company profile — name, tagline, about, website, industry, company size, employees, headquarters, founded year, specialties, follower count, and recent posts. Only publicly available data is returned.
Required Headers:
- x-api-key: Your API key
Parameters:
- url (string) [required]: The URL of the LinkedIn company page, e.g. `https://www.linkedin.com/company/shopify`.
- cache_max_age (select): Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh.
Example Response:
{
"data": {
"company": {
"id": "784652",
"url": "https://www.linkedin.com/company/shopify",
"handle": "shopify",
"name": "Shopify",
"tagline": "Make commerce better for everyone",
"description": "Shopify is a leading global commerce company, providing trusted tools to start, grow, market, and manage a retail business of any size. Shopify makes commerce b…",
"logoUrl": "https://media.licdn.com/dms/image/v2/D560BAQG_KjTcNcrLVw/company-logo_200_200/B56ZZolTV.HUAU-/0/1745511331439/shopify_logo?e=2147483647&v=beta&t=D2saVg58cKnwEiD…",
"coverImageUrl": "https://media.licdn.com/dms/image/v2/D563DAQGruQL8kvBvnw/image-scale_191_1128/B56ZanR4DSGoAs-/0/1746563203576/shopify_cover?e=2147483647&v=beta&t=rHubhVZZZSU_1V…",
"website": "https://www.shopify.com",
"industry": "Software Development",
"type": "Public Company",
"companySize": "10,001+ employees",
"employeeCount": 30135,
"headquarters": "Ottawa, ON",
"founded": 2006,
"specialties": [
"ecommerce"
],
"followerCount": 1113098,
"location": {
"locality": "Ottawa",
"region": "ON",
"country": "CA"
},
"posts": [
{
"id": "7511424930966654977",
"url": "https://www.linkedin.com/posts/shopify_theres-a-new-way-to-design-stores-on-shopify-activity-7511424930966654977-83Aa",
"text": "There’s a new way to design stores on Shopify. Introducing Canvas.\n\nDescribe your vision and Sidekick writes the code. No technical skills needed.\n\nSee your who…",
"headline": null,
"publishedAt": "2026-10-01T14:00:59.068Z",
"likeCount": 699
}
],
"employees": [
{
"name": "Joseph Smarr",
"url": "https://www.linkedin.com/in/jsmarr",
"imageUrl": "https://media.licdn.com/dms/image/v2/C5603AQG6JPHHDSVF_g/profile-displayphoto-shrink_100_100/profile-displayphoto-shrink_100_100/0/1600306045236?e=2147483647&v=…"
}
],
"similarCompanies": [
{
"name": "Stripe",
"url": "https://www.linkedin.com/company/stripe",
"industry": "Technology, Information and Internet",
"location": "South San Francisco, California",
"imageUrl": "https://media.licdn.com/dms/image/v2/D560BAQE2ZfJyfn-VCg/company-logo_100_100/B56ZlyKwpUKIAQ-/0/1758557047806/stripe_logo?e=2147483647&v=beta&t=fRMcaMGPJNFUMq_l…"
}
]
},
"fetchedAt": "2026-10-05T14:46:35.638Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}
Please help me write code in my preferred programming language to make this API call and handle the response appropriately. Include error handling and best practices.
```
## OpenAPI
````yaml /api-reference/openapi.json get /v1/linkedin/company
openapi: 3.0.3
info:
title: Scraperize API
version: 1.0.0
description: >-
Extract public data from social media platforms as clean JSON. Endpoints are
split by platform and by what they return, e.g. `GET /v1/twitter/tweet`.
## Authentication
Send your API key in the `x-api-key` header (or `Authorization: Bearer
`). Create keys in your dashboard.
## Credits
Each successful live scrape costs **1 credit**. Credits are prepaid and
never expire.
## Caching
Every endpoint accepts an optional `cache_max_age`
(`1d`|`3d`|`7d`|`14d`|`30d`). A cache hit within that window is returned for
**0 credits**.
## Responses
Success returns `{ "data": …, "meta": { "requestId", … } }`. Errors return
`{ "error": { "code", "message", "requestId" } }` with a matching HTTP
status. `meta` on a scrape carries `creditsCharged`, `creditsRemaining`,
`cached`, and (on a hit) `cachedAt`.
## Rate limits
Requests are limited per team per minute; over the limit returns `429` with
a `Retry-After` header.
servers:
- url: https://api.scraperize.com
description: Production
security:
- ApiKeyAuth: []
tags:
- name: Twitter
description: Twitter / X scraping endpoints
- name: Facebook
description: Facebook scraping endpoints
- name: Linkme
description: Linkme (link.me) scraping endpoints
- name: Amazon
description: Amazon (creator shop / storefront) scraping endpoints
- name: Linkbio
description: Linkbio (lnk.bio) scraping endpoints
- name: Pillar
description: Pillar (pillar.io) scraping endpoints
- name: Komi
description: Komi (komi.io) scraping endpoints
- name: Linktree
description: Linktree (linktr.ee) scraping endpoints
- name: Kick
description: Kick (kick.com) scraping endpoints
- name: Snapchat
description: Snapchat (snapchat.com) scraping endpoints
- name: Telegram
description: Telegram (t.me) scraping endpoints
- name: LinkedIn
description: LinkedIn scraping endpoints
- name: Twitch
description: Twitch scraping endpoints
- name: TikTok
description: TikTok (tiktok.com) scraping endpoints
paths:
/v1/linkedin/company:
get:
tags:
- LinkedIn
summary: Company
description: >-
Fetches a public LinkedIn company page and returns the company profile —
name, tagline, about, website, industry, company size, employees,
headquarters, founded year, specialties, follower count, and recent
posts. Only publicly available data is returned.
parameters:
- name: url
in: query
required: true
description: >-
The URL of the LinkedIn company page, e.g.
`https://www.linkedin.com/company/shopify`.
schema:
type: string
example: https://www.linkedin.com/company/shopify
- name: cache_max_age
in: query
required: false
description: >-
Optional. Return a cached result if one this age or newer exists —
served for **0 credits** with `meta.cached=true` and
`meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and
refreshes the cache. Omit to always scrape fresh.
schema:
type: string
enum:
- 1d
- 3d
- 7d
- 14d
- 30d
example: 7d
responses:
'200':
description: The company page.
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
company:
type: object
nullable: true
fetchedAt:
type: string
format: date-time
meta:
type: object
description: >-
requestId + credit/caching metadata (creditsCharged,
creditsRemaining, cached, cachedAt).
required:
- data
- meta
example:
data:
company:
id: '784652'
url: https://www.linkedin.com/company/shopify
handle: shopify
name: Shopify
tagline: Make commerce better for everyone
description: >-
Shopify is a leading global commerce company, providing
trusted tools to start, grow, market, and manage a retail
business of any size. Shopify makes commerce better for
everyone with a platform and services that are engineered
for reliability, while delivering a better shopping
experience for consumers everywhere. Shopify powers
millions of businesses in more than 175 countries and is
trusted by brands such as Allbirds, Gymshark, PepsiCo,
Staples, and many more.
Find all our jobs here: www.shopify.com/careers
logoUrl: >-
https://media.licdn.com/dms/image/v2/D560BAQG_KjTcNcrLVw/company-logo_200_200/B56ZZolTV.HUAU-/0/1745511331439/shopify_logo?e=2147483647&v=beta&t=D2saVg58cKnwEiDQgFgzvwL24mTRM_cPuU1ndv6kL2U
coverImageUrl: >-
https://media.licdn.com/dms/image/v2/D563DAQGruQL8kvBvnw/image-scale_191_1128/B56ZanR4DSGoAs-/0/1746563203576/shopify_cover?e=2147483647&v=beta&t=rHubhVZZZSU_1V8tCeBpwL80OG3bNBjzBNEWFO24qa4
website: https://www.shopify.com
industry: Software Development
type: Public Company
companySize: 10,001+ employees
employeeCount: 30135
headquarters: Ottawa, ON
founded: 2006
specialties:
- ecommerce
- API
- applications
followerCount: 1113098
location:
locality: Ottawa
region: 'ON'
country: CA
posts:
- id: '7511424930966654977'
url: >-
https://www.linkedin.com/posts/shopify_theres-a-new-way-to-design-stores-on-shopify-activity-7511424930966654977-83Aa
text: >-
There’s a new way to design stores on Shopify.
Introducing Canvas.
Describe your vision and Sidekick writes the code. No
technical skills needed.
See your whole store laid out on an infinite canvas so
you can understand how every page feels together.
Changes appear in real time.
https://lnkd.in/grb34xEE
headline: null
publishedAt: '2026-10-01T14:00:59.068Z'
likeCount: 699
- id: '7510675945612103680'
url: >-
https://www.linkedin.com/posts/shopify_entrepreneurs-run-your-business-from-muse-activity-7510675945612103680-sRF7
text: >-
Entrepreneurs, run your business from Muse. The
Shopify connector is live.
Connect your store and talk to your Muse about
products, orders, inventory, and analytics. It
remembers your goals and follows up before you ask.
You can even pull in context from Instagram and
Facebook, like how people are talking about your
brand.
headline: null
publishedAt: '2026-09-29T12:24:47.044Z'
likeCount: 234
- id: '7508680500828471296'
url: >-
https://www.linkedin.com/posts/shopify_you-use-shop-pay-and-now-your-muse-can-too-activity-7508680500828471296-0lVr
text: >-
You use Shop Pay, and now your Muse can too.
Direct checkout with Shop Pay is live in Muse by Meta.
Add it to your wallet.
headline: null
publishedAt: '2026-09-24T00:15:35.934Z'
likeCount: 178
employees:
- name: Joseph Smarr
url: https://www.linkedin.com/in/jsmarr
imageUrl: >-
https://media.licdn.com/dms/image/v2/C5603AQG6JPHHDSVF_g/profile-displayphoto-shrink_100_100/profile-displayphoto-shrink_100_100/0/1600306045236?e=2147483647&v=beta&t=SYwM63n268TcHjRQFbsz1EXXcGkXxKnYKNqNVUwDjA8
similarCompanies:
- name: Stripe
url: https://www.linkedin.com/company/stripe
industry: Technology, Information and Internet
location: South San Francisco, California
imageUrl: >-
https://media.licdn.com/dms/image/v2/D560BAQE2ZfJyfn-VCg/company-logo_100_100/B56ZlyKwpUKIAQ-/0/1758557047806/stripe_logo?e=2147483647&v=beta&t=fRMcaMGPJNFUMq_l1f2zzyX4PaK3yg-MRicyUuY3qSI
- name: Spotify
url: https://se.linkedin.com/company/spotify
industry: Musicians
location: Stockholm, Stockholm County
imageUrl: >-
https://media.licdn.com/dms/image/v2/C560BAQFkDzx_7dqq3A/company-logo_100_100/company-logo_100_100/0/1631377935713?e=2147483647&v=beta&t=AiRi3YW2R5kYKHbxsjkdQ_d1RuH6Yk98ePBwANPPDhc
- name: Airbnb
url: https://www.linkedin.com/company/airbnb
industry: Software Development
location: San Francisco, CA
imageUrl: >-
https://media.licdn.com/dms/image/v2/C560BAQFhfl32crIGIw/company-logo_100_100/company-logo_100_100/0/1630637496980/airbnb_logo?e=2147483647&v=beta&t=idNQqoBZi6dZq6iG78J5GTOsNV_ltJf7ITo7zYZ6VWg
fetchedAt: '2026-10-05T14:46:35.638Z'
meta:
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
creditsCharged: 1
creditsRemaining: 4999
cached: false
'401':
description: Missing, invalid, or revoked API key.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: UNAUTHORIZED
message: API key required — pass it in the `x-api-key` header.
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
'402':
description: Not enough credits for this request.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: INSUFFICIENT_CREDITS
message: >-
This request costs 1 credit, but your balance is 0. Top up
to continue.
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
'404':
description: No public company page found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: NOT_FOUND
message: >-
The requested content was not found (it may not exist, be
deleted, or be private).
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
'422':
description: Invalid query parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: VALIDATION_ERROR
message: Request validation failed
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
details:
- path: url
message: Required
'429':
description: Over the per-minute rate limit — honour `Retry-After`.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: RATE_LIMITED
message: >-
Rate limit exceeded — max 100 requests per 60s. Retry in
~30s.
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
'503':
description: >-
Temporarily unavailable — retry after `Retry-After`. `error.code`
tells you why: `UPSTREAM_BLOCKED` (the source blocked this request),
`EXTRACTION_FAILED` (the source returned unexpected data),
`PLATFORM_UNAVAILABLE` (the source is down), or
`SERVICE_UNAVAILABLE` (we are at capacity).
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: UPSTREAM_BLOCKED
message: >-
The source is temporarily unavailable. Please try again
shortly.
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
components:
schemas:
Error:
type: object
properties:
error:
type: object
properties:
code:
type: string
example: NOT_FOUND
message:
type: string
example: The requested content was not found.
requestId:
type: string
example: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
details:
type: array
items:
type: object
description: Present on validation errors.
required:
- code
- message
- requestId
required:
- error
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: >-
Your API key. Send it in the `x-api-key` header (or `Authorization:
Bearer `). Create and manage keys from your dashboard.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.