# Guru.com Jobs Scraper (`parsebird/guru-jobs-scraper`) Actor

Scrape freelance jobs and freelancer profiles from Guru.com by keyword, skill, and location. Get titles, budgets, descriptions, skills, and employer or freelancer details. Export as JSON, CSV, or Excel.

- **URL**: https://apify.com/parsebird/guru-jobs-scraper.md
- **Developed by:** [ParseBird](https://apify.com/parsebird) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.99 / 1,000 job listing / freelancer profiles

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/actors/running/actors-in-store.md#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

### Guru.com Jobs Scraper

Scrape freelance job listings and freelancer profiles from **[Guru.com](https://www.guru.com)** into clean, structured JSON. The Guru.com Jobs Scraper searches by keyword, skill, and location, pulls the job title, budget, full description, skills, and employer's total spend, or freelancer name, rate, earnings, and satisfaction — without the Guru.com API.

<table><tr>
<td style="border-left:4px solid #1C1917;padding:12px 16px;font-weight:600">
Search Guru.com jobs or freelancer profiles by keyword, skill, and location, filter jobs by fixed-price or hourly pricing, and get each job's full description and employer's total spend from its detail page.
</td>
</tr></table>

##### Copy to your AI assistant

Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor.

```
Actor: parsebird/guru-jobs-scraper (Apify). Scrapes freelance job listings and freelancer profiles from guru.com. Call with ApifyClient.
Input JSON fields: searchType: "jobs"|"freelancers" (default jobs); startUrl: string — direct Guru.com jobs/freelancers URL, overrides keyword/location/skill; keyword: string — search term e.g. "web developer"; skill: string — specific skill e.g. "javascript" (takes precedence over keyword); location: string — e.g. "United States"; job_type: "both"|"fixed"|"hourly" (jobs only, default both); results_wanted: int (default 20); max_pages: int (default 5); proxyConfiguration: object (RESIDENTIAL preset, required — Guru.com blocks datacenter IPs).
Output (jobs mode): title, url, price, description, skills, employerName, employerImage, spending, location, posted, deadline, scrapedAt. Output (freelancers mode): name, profileUrl, logo, location, earnings, satisfaction, hourlyRate, startingRate, description, skills, image, scrapedAt.
Example: { "searchType": "jobs", "keyword": "react developer", "results_wanted": 30 }
API: https://api.apify.com/v2/acts/parsebird~guru-jobs-scraper  ·  Token: https://console.apify.com/account/integrations
```

### What does Guru.com Jobs Scraper do?

[Guru.com](https://www.guru.com) is one of the longest-running freelance marketplaces, listing freelance jobs and freelancer profiles across programming, design, writing, sales & marketing, and more. There is no public Guru.com API — this scraper reads the site's own search-result and job-detail pages and returns them as structured data. For every keyword, skill, and location it extracts:

- 💼 **Job listings** — title, direct URL, fixed-price or hourly budget, full description, required skills, employer name, employer photo, and the employer's total spend on the platform.
- 👤 **Freelancer profiles** — name, profile URL, avatar, location, earnings in the last 12 months, feedback satisfaction, hourly and starting rates, top service description, skills, and cover image.
- 🎯 **Flexible targeting** — search by free-text keyword, a specific skill tag, a location, or paste any Guru.com jobs/freelancers URL directly to scrape that exact view.
- 💰 **Job-type filtering** — restrict job results to fixed-price only, hourly only, or both.

### What data can you extract from Guru.com?

**Jobs mode**

| Field | Description |
|-------|-------------|
| `title` | Job posting title |
| `url` | Direct link to the Guru.com job listing |
| `price` | Fixed-price range or hourly pricing as shown |
| `description` | Full job description, fetched from the job's detail page |
| `skills` | Skills and category tags attached to the job |
| `employerName` / `employerImage` | Employer's display name and avatar |
| `spending` | Employer's total spend on Guru.com, from the job's detail page |
| `location` | Employer's displayed country |
| `posted` / `deadline` | When the job was posted and the quote submission deadline |

**Freelancers mode**

| Field | Description |
|-------|-------------|
| `name` | Freelancer or agency display name |
| `profileUrl` | Direct link to the freelancer's profile |
| `location` | City, state/province, and country |
| `earnings` | Earnings displayed for the last 12 months |
| `satisfaction` | Feedback / satisfaction percentage |
| `hourlyRate` / `startingRate` | Rates listed on the freelancer's top service |
| `description` | Top service description or tagline |
| `skills` | Skills listed on the profile |
| `image` | Cover image from the top service listing |

### Input parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| searchType | string | No | `jobs` | Extraction mode: `jobs` or `freelancers`. |
| startUrl | string | No | — | Direct Guru.com URL to start from. Overrides keyword, location, and skill. |
| keyword | string | No | — | Search keyword, e.g. `web developer` or `data scientist`. |
| skill | string | No | — | Filter by a specific skill, e.g. `javascript` or `wordpress`. Takes precedence over `keyword`. |
| location | string | No | — | Geographic location filter, e.g. `United States`. |
| job\_type | string | No | `both` | Job pricing type filter: `fixed`, `hourly`, or `both`. Jobs mode only. |
| results\_wanted | integer | No | 20 | Maximum number of items to collect. |
| max\_pages | integer | No | 5 | Safety cap on the number of search-result pages to visit. |
| proxyConfiguration | object | No | Apify RESIDENTIAL proxy | Proxy settings. Residential proxies are required — Guru.com blocks datacenter IPs outright. |

### Example input

```json
{
  "searchType": "jobs",
  "keyword": "react developer",
  "results_wanted": 30
}
```

Freelancer profile search:

```json
{
  "searchType": "freelancers",
  "keyword": "content writer",
  "location": "United States",
  "results_wanted": 20
}
```

### Output example

Job listing record:

```json
{
  "title": "Mobile QA Automation Engineer",
  "url": "https://www.guru.com/jobs/mobile-qa-automation-engineer/2120816",
  "price": "Fixed Price | $500-$1k",
  "description": "Summary\nWe are looking for a mobile QA automation engineer to own test coverage for our iOS and Android apps...",
  "skills": ["Programming & Development", "Web Development & Design", "Web Design"],
  "employerName": "abdul M",
  "employerImage": "https://res.cloudinary.com/gurucom/image/upload/w_64,h_64,f_auto,dpr_2/.../lhpd9yveavx0f5xipins.jpg",
  "spending": "$0",
  "location": "Pakistan",
  "posted": "Posted on Sep 11, 2026",
  "deadline": "Oct 11, 2026",
  "scrapedAt": "2026-09-13T12:46:17.230Z"
}
```

Freelancer profile record:

```json
{
  "name": "Lindsey Fanders",
  "profileUrl": "https://www.guru.com/freelancers/lindsey-fanders",
  "logo": "https://res.cloudinary.com/gurucom/image/upload/w_96,h_96,f_auto,dpr_2/static/default-user.png",
  "location": "Mesquite, Texas, United States",
  "earnings": null,
  "satisfaction": null,
  "hourlyRate": "$40/hr",
  "startingRate": "$100",
  "description": "Providing niche appropriate original content based on your specific needs. Standard 500-1000 word articles, English only",
  "skills": ["Writing & Translation", "Content Writer", "Article Writing", "Content Writing", "English Language", "Writing"],
  "image": "https://res.cloudinary.com/gurucom/image/upload/f_auto,dpr_2/static/DefaultServiceCoverImgs/defaultsvcover_writing.jpg",
  "scrapedAt": "2026-09-13T12:46:50.553Z"
}
```

Download the dataset as JSON, CSV, Excel, XML, or HTML from the **Storage** tab or the [Apify API](https://docs.apify.com/api/v2).

### How to scrape Guru.com

1. Open the **Input** tab of the Guru.com Jobs Scraper.
2. Choose a **search type** — `jobs` or `freelancers`.
3. Enter a **keyword** (e.g. `web developer`) or a specific **skill** (e.g. `javascript`), and optionally a **location**.
4. For jobs, optionally set **job type** to `fixed` or `hourly`.
5. Set **results wanted** — start with 20–30 to keep the first run fast and cheap.
6. Click **Start**, then watch rows appear in the **Output** tab.
7. Export from **Storage**, or pull results via the API.

#### Run it via API

Python:

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("parsebird/guru-jobs-scraper").call(run_input={
    "searchType": "jobs",
    "keyword": "react developer",
    "results_wanted": 30,
})
for job in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(job["title"], "-", job["price"], "-", job["employerName"])
```

JavaScript:

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

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('parsebird/guru-jobs-scraper').call({
    searchType: 'freelancers',
    keyword: 'content writer',
    location: 'United States',
    results_wanted: 20,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

Schedule recurring runs, add webhooks, or push results to Google Sheets, Slack, Zapier, and Make with [Apify integrations](https://docs.apify.com/platform/integrations).

### Use cases

- 📈 **Freelance market research** — track how many jobs post for a given skill, and typical budgets.
- 🧭 **Lead generation for freelancers** — monitor new jobs matching your skill set every day.
- 🕵️ **Competitor / talent scouting** — pull freelancer profiles by skill and location to benchmark rates.
- 🔁 **Marketplace aggregation** — feed Guru.com listings into your own product alongside other freelance platforms.
- 📊 **Rate benchmarking** — aggregate `hourlyRate` and `startingRate` across a skill or location.

### How it works

1. The actor builds a Guru.com search URL from your keyword/skill and location (or uses your `startUrl` directly), and requests it through Apify's residential proxy with a Chrome browser fingerprint.
2. It reads the job or freelancer records embedded in each server-rendered results page and follows pagination up to `max_pages`.
3. In jobs mode, it applies the `job_type` filter, then opens each job's detail page for the full description and the employer's total spend.
4. Results are pushed to the dataset and billed once per item, up to `results_wanted`.

### How much does it cost to scrape Guru.com?

This actor uses **pay-per-result** pricing:

| Plan | Price per 1,000 items |
|------|------------------------|
| Free | **$1.29** |
| Bronze | $1.19 |
| Silver | $1.09 |
| Gold | $0.99 |

One event is charged per job or freelancer profile pushed to the dataset. Scraping 100 items costs about **$0.13** on the Free plan. Apify platform usage (compute + residential proxy) is billed separately per your plan.

### Is it legal to scrape Guru.com?

Scraping publicly available data is legal in most jurisdictions, and this actor only reads pages any visitor can load without logging in. It does not bypass authentication and does not collect personal contact details. You are responsible for how you use the data — review Guru.com's Terms of Use and Apify's guide on [the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/) before large-scale or commercial use.

### FAQ

**Do I need a Guru.com account?**
No. The scraper only reads public search results and job/profile pages.

**Why is `spending` sometimes `$0`?**
That's the employer's real total spend on Guru.com — many posters are new accounts or have paid outside the platform's tracked invoices.

**Why are `earnings` or `satisfaction` sometimes `null` for a freelancer?**
Guru.com only shows those figures once a freelancer has 12 months of tracked earnings or received feedback. New profiles show neither.

**Do I need a residential proxy?**
Yes. Guru.com sits behind a bot-detection layer that blocks every datacenter IP outright, so the residential proxy group is preset and required.

**What does the `skill` parameter match against?**
Guru.com's own skill taxonomy (e.g. `python`, `wordpress`, `content-writer`). Free-text `keyword` is matched the same way; `skill` wins if both are set.

**Something looks wrong or a field is missing.**
Open an issue on the **Issues** tab with your input and the run ID.

### Related actors

Browse all [ParseBird actors](https://apify.com/parsebird) for more freelance-marketplace and job-board scrapers.

# Actor input Schema

## `searchType` (type: `string`):

What to extract: freelance job postings, or freelancer profiles.

## `startUrl` (type: `string`):

A direct Guru.com jobs or freelancers URL (e.g. a category page). Overrides keyword, location, and skill when set.

## `keyword` (type: `string`):

Search keyword, e.g. `web developer` or `data scientist`.

## `skill` (type: `string`):

Filter by a specific skill, e.g. `javascript` or `wordpress`. Takes precedence over Keyword when both are set.

## `location` (type: `string`):

Geographic location filter, e.g. `United States` or `India`.

## `job_type` (type: `string`):

Job pricing type filter. Only applies to Jobs search.

## `results_wanted` (type: `integer`):

Maximum number of items to collect. Leave empty to collect all available (up to the page safety cap).

## `max_pages` (type: `integer`):

Safety cap on the number of search-result pages to visit (about 20 items per page).

## `proxyConfiguration` (type: `object`):

Guru.com blocks datacenter IPs outright, so residential proxy routing is required and preset. Change it only for an account-specific setup.

## Actor input object example

```json
{
  "searchType": "jobs",
  "keyword": "react developer",
  "job_type": "both",
  "results_wanted": 20,
  "max_pages": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `dataset` (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 = {
    "searchType": "jobs",
    "startUrl": "",
    "keyword": "react developer",
    "skill": "",
    "location": "",
    "job_type": "both",
    "results_wanted": 20,
    "max_pages": 5,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("parsebird/guru-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 = {
    "searchType": "jobs",
    "startUrl": "",
    "keyword": "react developer",
    "skill": "",
    "location": "",
    "job_type": "both",
    "results_wanted": 20,
    "max_pages": 5,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("parsebird/guru-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 '{
  "searchType": "jobs",
  "startUrl": "",
  "keyword": "react developer",
  "skill": "",
  "location": "",
  "job_type": "both",
  "results_wanted": 20,
  "max_pages": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call parsebird/guru-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parsebird/guru-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/GbTvXY50eLB4WzWME/builds/8bbwP1zBWPQVYQia7/openapi.json
