Company hiring (job postings)

curl --request POST \
  --url https://app.pipecorn.com/api/v2/accounts/company_hiring \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "company_domain": "notion.so"
}
'

{
  "total_jobs": 42,
  "truncated": true,
  "company": {
    "name": "Acme",
    "domain": "acme.com",
    "linkedin_url": "https://linkedin.com/company/acme"
  },
  "jobs": [
    {
      "job_title": "Senior Backend Engineer",
      "job_url": "https://example.com/jobs/1",
      "job_location": "Paris France",
      "employment_statuses": [
        "full_time"
      ],
      "date_posted": "2026-05-30",
      "description": "Build cool stuff with Rails.",
      "hiring_team": [
        {
          "name": "Alice Doe",
          "title": "Engineering Manager",
          "linkedin_url": "https://linkedin.com/in/alice"
        }
      ]
    }
  ]
}

{
  "error": 400,
  "message": "Provide at least one of: company_domain, company_name, company_linkedin_url"
}

{
  "error": 401,
  "message": "Unauthorized"
}

{
  "error": "Not enough enrichment credits left",
  "code": "insufficient_credits",
  "top_up_url": "https://app.pipecorn.com/settings/subscriptions/credits"
}

{
  "error": "You have reached your weekly enrichment credit limit for this workspace",
  "code": "workspace_limit_exceeded"
}

{
  "error": 422,
  "message": "Invalid country code(s): USA. Use 2-letter ISO 3166-1 alpha-2 codes (e.g. US, FR)."
}

{
  "error": 429,
  "message": "Too many requests"
}

POST

accounts

company_hiring

curl --request POST \
  --url https://app.pipecorn.com/api/v2/accounts/company_hiring \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "company_domain": "notion.so"
}
'

{
  "total_jobs": 42,
  "truncated": true,
  "company": {
    "name": "Acme",
    "domain": "acme.com",
    "linkedin_url": "https://linkedin.com/company/acme"
  },
  "jobs": [
    {
      "job_title": "Senior Backend Engineer",
      "job_url": "https://example.com/jobs/1",
      "job_location": "Paris France",
      "employment_statuses": [
        "full_time"
      ],
      "date_posted": "2026-05-30",
      "description": "Build cool stuff with Rails.",
      "hiring_team": [
        {
          "name": "Alice Doe",
          "title": "Engineering Manager",
          "linkedin_url": "https://linkedin.com/in/alice"
        }
      ]
    }
  ]
}

{
  "error": 400,
  "message": "Provide at least one of: company_domain, company_name, company_linkedin_url"
}

{
  "error": 401,
  "message": "Unauthorized"
}

{
  "error": "Not enough enrichment credits left",
  "code": "insufficient_credits",
  "top_up_url": "https://app.pipecorn.com/settings/subscriptions/credits"
}

{
  "error": "You have reached your weekly enrichment credit limit for this workspace",
  "code": "workspace_limit_exceeded"
}

{
  "error": 422,
  "message": "Invalid country code(s): USA. Use 2-letter ISO 3166-1 alpha-2 codes (e.g. US, FR)."
}

{
  "error": 429,
  "message": "Too many requests"
}

Get the list of open job postings indexed for a company using one company identifier (domain, company name, or LinkedIn URL). Results are sourced from TheirStack.

Credits and rate limits

Credits: 1 credit per job returned. You are only charged for the jobs actually returned, and never for more jobs than your available credits allow. A lookup that returns no jobs costs nothing.
Rate limit: 5 requests per second per user

If your balance cannot cover the lookup, the request is rejected with 402 Payment Required and code: "insufficient_credits" before any job is fetched. A workspace weekly credit limit returns 403 Forbidden with code: "workspace_limit_exceeded" instead. See Credit and limit errors.

Required identification

Provide at least one of:

company_domain
company_name
company_linkedin_url

If none are provided, the API returns:

{
  "error": 400,
  "message": "Provide at least one of: company_domain, company_name, company_linkedin_url"
}

Optional parameters

posted_within_days: Only return jobs posted within the last N days. Must be one of the selectable look-back windows: 7, 30, 60, 90, or 180. Defaults to 30 when omitted; any other value returns 422.
limit: Maximum number of jobs to return, a positive integer capped at 100. Because billing is per job, use this to bound how many credits a single lookup can spend. Only enough pages to satisfy the limit are fetched.
full_description: When true, return each job’s full description. Defaults to false, in which case descriptions are truncated to a 300-character snippet.
job_title_keywords: Array of strings. Only return jobs whose title matches one of these keywords.
excluded_job_title_keywords: Array of strings. Exclude jobs whose title matches one of these keywords.
job_description_keywords: Array of strings. Only return jobs whose description contains one of these keywords.
excluded_job_description_keywords: Array of strings. Exclude jobs whose description contains one of these keywords.
job_country_codes: Array of 2-letter ISO 3166-1 alpha-2 country codes (e.g. US, FR). Only return jobs located in these countries. Codes are case-insensitive.
excluded_job_country_codes: Array of 2-letter ISO 3166-1 alpha-2 country codes. Exclude jobs located in these countries.

Each keyword filter must be an array of strings, otherwise the API returns 422. Invalid country codes also return 422.

Example request

{
  "company_domain": "notion.so",
  "posted_within_days": 30,
  "limit": 10,
  "full_description": false,
  "job_title_keywords": ["engineer", "developer"],
  "excluded_job_title_keywords": ["intern"],
  "job_country_codes": ["US", "FR"]
}

Example response

The truncated flag is true when more jobs matched than were returned (because of the limit, the 100-job ceiling, or your available credits).

{
  "total_jobs": 42,
  "truncated": true,
  "company": {
    "name": "Acme",
    "domain": "acme.com",
    "linkedin_url": "https://linkedin.com/company/acme"
  },
  "jobs": [
    {
      "job_title": "Senior Backend Engineer",
      "job_url": "https://example.com/jobs/1",
      "job_location": "Paris France",
      "employment_statuses": ["full_time"],
      "date_posted": "2026-05-30",
      "description": "Build cool stuff with Rails.",
      "hiring_team": [
        {
          "name": "Alice Doe",
          "title": "Engineering Manager",
          "linkedin_url": "https://linkedin.com/in/alice"
        }
      ]
    }
  ]
}

Authorizations

X-API-KEY

string

header

required

Your API key

Body

application/json

company_domain

string

Company website domain

Example:

"notion.so"

company_name

string

Company name

Example:

"Notion"

company_linkedin_url

string<uri>

LinkedIn company URL

Example:

"https://www.linkedin.com/company/notionhq/"

posted_within_days

enum<integer>

default:30

Only return jobs posted within the last N days. Must be one of the selectable look-back windows: 7, 30, 60, 90, or 180. Defaults to 30 when omitted; any other value returns 422.

Available options:

7,

30,

60,

90,

180

Example:

30

limit

integer

Maximum number of jobs to return. A positive integer capped at 100. Because billing is 1 credit per job, use this to bound how many credits a single lookup can spend. Only enough pages to satisfy the limit are fetched.

Required range: 1 <= x <= 100

Example:

10

full_description

boolean

default:false

When true, return each job's full description. Defaults to false, in which case descriptions are truncated to a 300-character snippet.

Example:

false

job_title_keywords

string[]

Only return jobs whose title matches one of these keywords.

Example:

["engineer", "developer"]

excluded_job_title_keywords

string[]

Exclude jobs whose title matches one of these keywords.

Example:

["intern"]

job_description_keywords

string[]

Only return jobs whose description contains one of these keywords.

Example:

["rails", "ruby"]

excluded_job_description_keywords

string[]

Exclude jobs whose description contains one of these keywords.

Example:

["php"]

job_country_codes

string[]

Only return jobs located in these countries. 2-letter ISO 3166-1 alpha-2 country codes (e.g. US, FR); case-insensitive.

Example:

["US", "FR"]

excluded_job_country_codes

string[]

Exclude jobs located in these countries. 2-letter ISO 3166-1 alpha-2 country codes (e.g. US, FR); case-insensitive.

Example:

["CA"]

Response

Successfully retrieved job postings

total_jobs

integer

Total number of matching job postings (may exceed the number returned)

Example:

42

truncated

boolean

True when more jobs matched than were returned (because of the limit, the 100-job ceiling, or your available credits).

Example:

true

company

object

The hiring company, resolved from the first matching job.

Show child attributes

jobs

object[]

List of job postings

Show child attributes

Overview

Leads (People)

Accounts (Companies)

Waterfall Enrichment

Signals

Searches

Personas

Lists

Miscellaneous

API Reference

Credits and rate limits

Required identification

Optional parameters

Example request

Example response

Authorizations

Body

Response

​Credits and rate limits

​Required identification

​Optional parameters

​Example request

​Example response

Authorizations

Body

Response

Credits and rate limits

Required identification

Optional parameters

Example request

Example response