Skip to main content
POST
/
v1
/
data
/
companies
/
jobs
Get All Company Jobs
curl --request POST \
  --url https://api.linkupapi.com/v1/data/companies/jobs \
  --header 'Content-Type: application/json' \
  --data '{
  "company_names": [
    {}
  ],
  "job_title": [
    {}
  ],
  "job_title_include_all": true,
  "job_title_excluded": [
    {}
  ],
  "location": "<string>",
  "is_remote": true,
  "job_type": "<string>",
  "hours_old": 123,
  "total_results": 123,
  "fetch_description": true,
  "enrich_company": true,
  "start_page": 123,
  "end_page": 123
}'
{
  "status": "success",
  "data": {
    "companies": [
      {
        "name": "Alpic",
        "website": "https://www.alpic.ai",
        "indeed_url": null,
        "linkedin_url": "https://fr.linkedin.com/company/alpic-ai",
        "tagline": "Bring your product into the agent era.",
        "description": "Alpic provides the infrastructure and tools to turn your product into an AI-native experience...",
        "logo": "https://media.licdn.com/dms/image/.../alpic_ai_logo...",
        "cover_image": "https://media.licdn.com/dms/image/.../alpic_ai_cover...",
        "industry": "Technology, Information and Internet",
        "employee_count": 8,
        "employee_count_range": {
          "start": 2,
          "end": 10
        },
        "organization_type": "Privately Held",
        "headquarter": {
          "country": "FR",
          "city": "Paris"
        },
        "locations": [
          {
            "address": {
              "line1": "Paris, FR"
            },
            "headquarter": true
          }
        ],
        "followers_count": 1178,
        "jobs_count": 1,
        "jobs": [
          {
            "job_title": "Junior Software Engineer",
            "location": "Paris, Île-de-France, France",
            "job_type": null,
            "job_seniority": "",
            "job_board": "linkedin",
            "job_board_url": "https://www.linkedin.com/jobs/view/4300503473",
            "date_posted": "2025-09-13",
            "description": null,
            "is_remote": false,
            "salary": null
          }
        ]
      }
    ]
  },
  "pagination": {
    "start_page": 1,
    "end_page": 2,
    "results_per_page": 10,
    "pages_fetched": 2
  }
}

Overview

This endpoint retrieves all active job postings from specified companies.
The company_names parameter is required. Only LinkedIn will be scraped as the job board.
Pricing: Total Cost = Base + Description + Enrichment
  • Base: ⌈jobs / 10⌉ credits (1 credit = 10 jobs)
  • Description (if fetch_description: true): +1 credit = 10 description
  • Enrichment (if enrich_company: true): +1 credit per company

Body Parameters

company_names
array
required
List of company names to extract jobs from (e.g., ["Google", "Amazon"])
job_title
array
Keywords for job title (e.g., ["developer", "engineer"])
job_title_include_all
boolean
default:"false"
If true: all keywords required (AND logic). If false: at least one keyword (OR logic)
job_title_excluded
array
Keywords to exclude from job title (e.g., ["senior", "manager"])
location
string
Location (city, region). Example: "Paris, France" or "San Francisco, CA"
is_remote
boolean
default:"false"
Filter only remote jobs
job_type
string
Type of contract. Values: fulltime, parttime, internship, contract
hours_old
integer
Jobs posted within the last X hours (e.g., 72 for 3 days)
total_results
integer
default:"100"
Maximum number of jobs to retrieve per company
fetch_description
boolean
default:"true"
Fetch complete job descriptions. Cost: +⌈companies / 10⌉ credits
enrich_company
boolean
default:"false"
Enrich with LinkedIn data (tagline, followers, HQ, locations). Cost: +1 credit per company
start_page
integer
default:"1"
Start page for pagination
end_page
integer
End page for pagination

Response

companies
array
credits_cost
integer
Credits consumed for this request
credits_remaining
integer
Remaining credits in your account
nb_companies
integer
Number of companies returned
nb_jobs
integer
Total number of jobs found
{
  "status": "success",
  "data": {
    "companies": [
      {
        "name": "Alpic",
        "website": "https://www.alpic.ai",
        "indeed_url": null,
        "linkedin_url": "https://fr.linkedin.com/company/alpic-ai",
        "tagline": "Bring your product into the agent era.",
        "description": "Alpic provides the infrastructure and tools to turn your product into an AI-native experience...",
        "logo": "https://media.licdn.com/dms/image/.../alpic_ai_logo...",
        "cover_image": "https://media.licdn.com/dms/image/.../alpic_ai_cover...",
        "industry": "Technology, Information and Internet",
        "employee_count": 8,
        "employee_count_range": {
          "start": 2,
          "end": 10
        },
        "organization_type": "Privately Held",
        "headquarter": {
          "country": "FR",
          "city": "Paris"
        },
        "locations": [
          {
            "address": {
              "line1": "Paris, FR"
            },
            "headquarter": true
          }
        ],
        "followers_count": 1178,
        "jobs_count": 1,
        "jobs": [
          {
            "job_title": "Junior Software Engineer",
            "location": "Paris, Île-de-France, France",
            "job_type": null,
            "job_seniority": "",
            "job_board": "linkedin",
            "job_board_url": "https://www.linkedin.com/jobs/view/4300503473",
            "date_posted": "2025-09-13",
            "description": null,
            "is_remote": false,
            "salary": null
          }
        ]
      }
    ]
  },
  "pagination": {
    "start_page": 1,
    "end_page": 2,
    "results_per_page": 10,
    "pages_fetched": 2
  }
}