# iGuopin Jobs Scraper 国聘: China SOE & Campus Jobs (`getascraper/iguopin-jobs-scraper`) Actor

Collect public 国聘 job listings for China state-owned enterprises, campus recruitment, salaries, skills, locations, and employer intelligence.

- **URL**: https://apify.com/getascraper/iguopin-jobs-scraper.md
- **Developed by:** [GetAScraper](https://apify.com/getascraper) (community)
- **Categories:** Jobs, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.12 / 1,000 job postings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## 💼 iGuopin Jobs Scraper 国聘: China SOE & Campus Jobs

<table width="100%" style="table-layout:fixed;border-collapse:collapse">
<tr>
<td colspan="2" style="padding:14px 18px;background:#EDF9F6;border-top:3px solid #006A5B;border-left:1px solid #D6D3D1;border-right:1px solid #D6D3D1;border-radius:8px 8px 0 0">
<span style="font-size:16px;font-weight:700;color:#1C1917">Collect public 国聘 SOE and campus hiring data in one run.</span> <span style="font-size:15px;color:#57534E">iGuopin publishes state-owned-enterprise and graduate roles with salary, education, skills, and application-window fields for workforce research and job-data products.</span>
</td>
</tr>
<tr>
<td colspan="2" style="padding:10px 14px;background:#006A5B;border-left:1px solid #D6D3D1;border-right:1px solid #D6D3D1">
<span style="color:#FFFFFF;font-size:14px;font-weight:700;letter-spacing:0.5px">China campus and public recruitment</span>
<span style="color:#FDE8C8;font-size:13px">&nbsp;&nbsp;&bull;&nbsp;&nbsp;Campus hiring and national civil-service postings</span>
</td>
</tr>
<tr>
<td style="padding:10px 12px;border-left:1px solid #D6D3D1;border-bottom:1px solid #D6D3D1;vertical-align:top;width:50%;background:#EDF9F6;border-radius:0 0 0 8px">
<span style="overflow-wrap:break-word;word-break:break-word"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/jNDbFabbVxMhnQNb4-actor-7o0pzaHJlQjuWfJIQ-8OgnhF1vUV-images_%2819%29.jpeg" width="20" height="20" style="vertical-align:middle;border-radius:4px"> &nbsp;<a href="https://apify.com/getascraper/iguopin-jobs-scraper" style="color:#006A5B;text-decoration:none;font-weight:700;font-size:13px">iGuopin</a></span><br>
<span style="color:#006A5B;font-size:11px;font-weight:700">&#10148; You are here</span>
</td>
<td style="padding:10px 12px;border-left:1px solid #D6D3D1;border-right:1px solid #D6D3D1;border-bottom:1px solid #D6D3D1;vertical-align:top;width:50%;background:#FFFFFF;border-radius:0 0 8px 0">
<span style="overflow-wrap:break-word;word-break:break-word"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/jNDbFabbVxMhnQNb4-actor-u3lvE2BUy2n03teF9-EdQwozwk8Z-ncss_vica_logo_%281%29.jpeg" width="20" height="20" style="vertical-align:middle;border-radius:4px"> &nbsp;<a href="https://apify.com/getascraper/ncss-jobs-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">NCSS</a></span><br>
<span style="color:#57534E;font-size:11px">Graduate &amp; internship listings</span>
</td>
</tr>
</table>

<table width="100%">
<tr>
<td style="padding:24px 28px;background:#EDF9F6;border:1px solid #B8E2D8;border-top:4px solid #006A5B;border-radius:12px">
<span style="font-size:23px;font-weight:800;color:#1C1917;line-height:1.3">Public 国聘 SOE and campus hiring data in one run</span><br>
<span style="font-size:15px;color:#57534E;line-height:1.6">Collect iGuopin (国聘) state-owned-enterprise and graduate roles with salary, education, major, skills, and application-window fields for workforce research and job-data products.</span>
</td>
</tr>
</table>

<table width="100%">
<tr>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #B8E2D8;border-radius:10px 0 0 10px;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#006A5B">🎓 Campus and SOE scope</span><br>
<span style="font-size:12px;color:#57534E">Choose Campus, Social, or All hiring scope in one run.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #B8E2D8;border-left:none;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#006A5B">💰 Wage range fields</span><br>
<span style="font-size:12px;color:#57534E">Published salary min, max, and payment months in CNY.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #B8E2D8;border-left:none;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#006A5B">📅 Application windows</span><br>
<span style="font-size:12px;color:#57534E">Published application start and end dates when available.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #B8E2D8;border-left:none;border-radius:0 10px 10px 0;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#006A5B">🏢 Employer ownership</span><br>
<span style="font-size:12px;color:#57534E">Published employer nature, industry, and size fields.</span>
</td>
</tr>
</table>

iGuopin (国聘) is a public Chinese recruitment source with state-owned enterprise and campus hiring coverage. This Actor provides genuine public listing fields for job-data products, workforce research, and employer hiring analysis. It does not collect candidate profiles or private contact information.

### 🎯 Who uses this China jobs data?

- **Job-data product teams** adding public SOE and graduate hiring coverage.
- **Workforce researchers** comparing salary, education, major, and location requirements.
- **University career teams** studying available campus opportunities and application windows.
- **Market-intelligence analysts** tracking employer, industry, and role signals.

### 🚀 How to use it

<table width="100%"><tr><td style="padding:16px 14px;width:33%;background:#EDF9F6;border:1px solid #B8E2D8;border-radius:10px 0 0 10px;vertical-align:top"><b style="color:#1C1917">STEP 1</b><br><span style="color:#57534E">Choose Campus, Social, or All hiring scope.</span></td><td style="padding:16px 14px;width:33%;background:#EDF9F6;border:1px solid #B8E2D8;border-left:none;vertical-align:top"><b style="color:#1C1917">STEP 2</b><br><span style="color:#57534E">Optionally narrow by verified public filters.</span></td><td style="padding:16px 14px;width:33%;background:#EDF9F6;border:1px solid #B8E2D8;border-left:none;border-radius:0 10px 10px 0;vertical-align:top"><b style="color:#1C1917">STEP 3</b><br><span style="color:#57534E">Start with a small cap to confirm the returned scope.</span></td></tr></table>

### ⚙️ Input

| Field                                  | Type             | Required | Description                                                                                                   |
| -------------------------------------- | ---------------- | -------- | ------------------------------------------------------------------------------------------------------------- |
| `query`                                | string           | No       | Keyword used to find public 国聘 roles. The default starts with 数据.                                         |
| `jobScope`                             | string           | No       | Plain-language hiring scope: campus (default), social, or all available jobs.                                 |
| `locationIds`                          | array            | No       | Verified public location selections for Beijing, Shanghai, Guangzhou, Shenzhen, Hangzhou, Chengdu, and Wuhan. |
| `recruitmentTypes`, `categoryIds`      | array            | No       | Verified public recruitment-type and job-category selections.                                                 |
| `minMonthlySalary`, `maxMonthlySalary` | integer          | No       | Optional source wage range in CNY; supply both bounds together.                                               |
| `educationLevels`, `experienceLevels`  | array            | No       | Verified published education and experience requirements.                                                     |
| `companyNatures`, `industryIds`        | array            | No       | Verified reported employer ownership and industry selections.                                                 |
| `maxItems`                             | integer          | No       | Maximum unique jobs saved in one run. The default returns 10 records.                                         |
| `outputMode`                           | string           | No       | Full returns every available field; compact returns core fields for feeds and alerts.                         |
| `natureIds`                            | array of strings | No       | Advanced backward-compatible override for source job-nature IDs. Non-empty values override `jobScope`.        |

### 📊 Data table

| Field                                                     | Type           | Description                                                                     |
| --------------------------------------------------------- | -------------- | ------------------------------------------------------------------------------- |
| `jobId`                                                   | string         | Stable public job identifier.                                                   |
| `title`                                                   | string         | Job title.                                                                      |
| `companyId`, `companyName`                                | string         | Source employer identifier and name when published.                             |
| `companyNature`, `companyIndustry`, `companySize`         | string         | Published employer ownership, industry, and size.                               |
| `companyLogo`                                             | string         | Public employer logo URL when published.                                        |
| `recruitmentType`, `jobNature`, `jobCategory`             | string         | Published role classification fields.                                           |
| `openings`                                                | number         | Published opening count.                                                        |
| `salaryMin`, `salaryMax`, `salaryMonths`                  | number         | Published wage range and salary-payment months.                                 |
| `salaryUnit`                                              | string         | Published wage unit.                                                            |
| `salaryNegotiable`                                        | boolean        | Whether the source marks salary as negotiable.                                  |
| `education`, `experience`                                 | string         | Published education and experience requirements.                                |
| `majors`, `skills`                                        | array          | Published accepted majors and skill tags.                                       |
| `location`, `address`, `latitude`, `longitude`            | string, number | Published workplace location, address, and first reported location coordinates. |
| `applicationAllowed`                                      | boolean        | Whether the source currently marks applications as allowed.                     |
| `description`                                             | string         | Public job description when available.                                          |
| `applicationStartsAt`, `applicationEndsAt`                | string         | Published application window.                                                   |
| `sourceCreatedAt`, `sourceUpdatedAt`, `sourceRefreshedAt` | string         | Source timestamps when published.                                               |
| `sourceUrl`, `scrapedAt`                                  | string         | Collection provenance and collection time.                                      |

### 🗂️ Choose the right data view

- **📋 Job listings**: current roles, locations, and requirements.
- **💰 Salary and skills**: published wage, major, and skills analysis.
- **🏢 Employer intelligence**: employer ownership, industry, and size context.

### 💰 Pricing

Pricing is pay per result. Only job rows saved to the dataset are chargeable. Empty searches and the run summary do not create result charges. There is no subscription.

### ⭐ Enjoying iGuopin Jobs Scraper?

<table width="100%"><tr><td style="padding:20px 24px;background:#EDF9F6;border:1px solid #B8E2D8;border-left:5px solid #006A5B;border-radius:10px 10px 0 0"><span style="font-size:20px;letter-spacing:4px;color:#1C1917">⭐ ⭐ ⭐ ⭐ ⭐</span><br><b style="color:#1C1917">Found useful public SOE or campus hiring data for your workflow?</b><br><span style="color:#57534E">A rating helps workforce researchers and job-data teams find this Actor. It also tells us what public fields to improve next.</span></td></tr><tr><td style="padding:0;background:#006A5B;border:1px solid #B8E2D8;border-top:none;border-radius:0 0 10px 10px;text-align:center"><a href="https://apify.com/getascraper/iguopin-jobs-scraper/reviews" style="display:block;padding:13px 16px;color:#FFFFFF;text-decoration:none;font-weight:800">★&nbsp;&nbsp;Rate this Actor on Apify</a></td></tr></table>

### ❓ FAQ

##### Can I collect 国聘 campus jobs?

Yes. Campus recruitment is the default Hiring scope. You can choose social recruitment or all available jobs; existing `natureIds` integrations remain supported as an advanced override.

##### 国聘招聘数据可以导出吗？

Yes. The Actor saves genuine public job and employer fields in the Apify dataset, which you can export in the Console.

##### Is this an official 国聘 API?

No. This is an independent data tool for public job listings. It is not affiliated with iGuopin or 国聘.

##### Why are salary, skills, or an address sometimes missing?

The source does not publish every field for every role. Unavailable values are omitted instead of being invented.

### 🔗 Other actors

- [Zhaopin Scraper 智联招聘: China Jobs & Salary API](https://apify.com/getascraper/zhaopin-jobs-scraper) ↗ - Monitor China jobs, salaries, skills, and hiring changes.
- [51job China Jobs Scraper](https://apify.com/getascraper/51job-scraper) ↗ - Collect public 51job listings with job and employer fields.
- [Lagou Tech Jobs Scraper](https://apify.com/getascraper/lagou-tech-jobs-scraper) ↗ - Research public China technology jobs and hiring signals.
- [Liepin Scraper](https://apify.com/getascraper/liepin-scraper) ↗ - Collect public professional job listings in China.

# Actor input Schema

## `query` (type: `string`):

Optional keyword to find matching public 国聘 roles, such as 数据分析, 软件工程师, or 财务.

## `jobScope` (type: `string`):

Choose campus jobs, social recruitment, or every available public job nature. The advanced natureIds field overrides this choice when supplied.

## `locationIds` (type: `array`):

Limit jobs to these verified public 国聘 location codes. Leave empty for every location.

## `recruitmentTypes` (type: `array`):

Keep public listings with the selected source recruitment types.

## `categoryIds` (type: `array`):

Select from public categories observed in the 国聘 listing source.

## `minMonthlySalary` (type: `integer`):

Lower bound for the source wage range. Supply both salary bounds or neither.

## `maxMonthlySalary` (type: `integer`):

Upper bound for the source wage range. Supply both salary bounds or neither.

## `educationLevels` (type: `array`):

Keep jobs that publish one of these source education requirements.

## `experienceLevels` (type: `array`):

Keep jobs that publish one of these source experience requirements.

## `companyNatures` (type: `array`):

Keep public listings from employers with the selected reported ownership type.

## `industryIds` (type: `array`):

Select public industries observed in the 国聘 listing source.

## `maxItems` (type: `integer`):

Maximum unique job listings to save. A small first run helps confirm your search scope.

## `outputMode` (type: `string`):

Full keeps every available source field. Compact keeps core identity, employer, classification, salary, location, application, and provenance fields.

## `natureIds` (type: `array`):

Optional raw 国聘 job-nature IDs. Non-empty values override Hiring scope for backward compatibility.

## `pageSize` (type: `integer`):

Internal paging control. Leave at the default unless an existing integration needs a specific page size.

## `startPage` (type: `integer`):

Internal paging control. Leave at page 1 unless an existing integration needs a specific source page range.

## Actor input object example

```json
{
  "query": "数据",
  "jobScope": "campus",
  "locationIds": [],
  "recruitmentTypes": [],
  "categoryIds": [],
  "educationLevels": [],
  "experienceLevels": [],
  "companyNatures": [],
  "industryIds": [],
  "maxItems": 10,
  "outputMode": "full",
  "natureIds": [],
  "pageSize": 10,
  "startPage": 1
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `runSummary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "query": "数据",
    "jobScope": "campus",
    "locationIds": [],
    "recruitmentTypes": [],
    "categoryIds": [],
    "educationLevels": [],
    "experienceLevels": [],
    "companyNatures": [],
    "industryIds": [],
    "maxItems": 10,
    "outputMode": "full",
    "natureIds": [],
    "pageSize": 10,
    "startPage": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("getascraper/iguopin-jobs-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "query": "数据",
    "jobScope": "campus",
    "locationIds": [],
    "recruitmentTypes": [],
    "categoryIds": [],
    "educationLevels": [],
    "experienceLevels": [],
    "companyNatures": [],
    "industryIds": [],
    "maxItems": 10,
    "outputMode": "full",
    "natureIds": [],
    "pageSize": 10,
    "startPage": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("getascraper/iguopin-jobs-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "query": "数据",
  "jobScope": "campus",
  "locationIds": [],
  "recruitmentTypes": [],
  "categoryIds": [],
  "educationLevels": [],
  "experienceLevels": [],
  "companyNatures": [],
  "industryIds": [],
  "maxItems": 10,
  "outputMode": "full",
  "natureIds": [],
  "pageSize": 10,
  "startPage": 1
}' |
apify call getascraper/iguopin-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,getascraper/iguopin-jobs-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/7o0pzaHJlQjuWfJIQ/builds/CzgSU9tAnRV8Y7YNx/openapi.json