Freelance Opportunity Intelligence

Turn the public Freelancer.com project feed into a ranked shortlist of the opportunities worth bidding on. Each active project is scored 0–100 on how well it fits your skills, how large its budget is, how little competition it has and how clearly its budget is defined — then filtered by your keywords and budget and sorted best-first. Every score is built from transparent, checkable components; the Actor never invents conclusions.

What does this Actor do?

1. Fetch — pulls active projects from the Freelancer.com public read API for your keyword.
2. Match & score — for each project, computes the intersection of your skills with the project's required skills (case-insensitive) and an auditable opportunity score.
3. Filter — applies an optional keyword filter (title/skills) and your budget bounds.
4. De-duplicate & rank — collapses repeats by project URL and sorts by opportunity score.

Runs on the Apify platform with proxy rotation, scheduling, API access and dataset export built in.

Why use it?

• Freelancers and agencies get a pre-scored bid list instead of scrolling an endless feed — the best-fit, best-value, least-crowded projects float to the top.
• Every project shows exactly which of your skills matched and how it scored, so you can decide fast.

How to use it

1. Enter a keyword (e.g. web scraping).
2. List your skills (e.g. Python, Scrapy) — projects are scored on how many they need.
3. Optionally set min/max budget and an extra keyword filter.
4. Run the Actor and download the dataset as JSON, CSV or Excel.

Input

Field	Type	Description
keyword	string	Keyword passed to the project search.
skills	array	Your skills, used for match scoring (case-insensitive).
minBudget	integer	Only keep projects with a minimum budget ≥ this (optional).
maxBudget	integer	Only keep projects with a maximum budget ≤ this (optional).
maxResults	integer	Max scored opportunities to return (default 50).
keywordFilter	array	Optional: keep only projects whose title/skills contain one of these terms.
proxyConfiguration	object	Proxy settings (optional for this public API).

Input example

{
  "keyword": "web scraping",
  "skills": ["Python", "Scrapy", "Web Scraping"],
  "minBudget": 250,
  "maxBudget": 5000,
  "maxResults": 50,
  "keywordFilter": ["scraping", "crawler"]
}

Output

One dataset record per unique opportunity, sorted by opportunityScore (highest first):

Field	Description
title	Project title.
budgetMin, budgetMax, currency	Budget range and its currency.
skills	Required skills for the project.
category, type	Project category / engagement type (e.g. fixed vs hourly).
bidCount, postedDate	Competition and recency signals.
url	Public project URL.
matchedSkills, skillMatchCount	Which of your skills the project needs, and how many.
opportunityScore	Auditable 0–100 fit/value/competition score.

Output example

{
  "title": "Build a Python web scraper for e-commerce",
  "budgetMin": 250,
  "budgetMax": 750,
  "currency": "USD",
  "skills": ["Python", "Web Scraping", "Scrapy"],
  "category": "fixed",
  "type": "fixed",
  "bidCount": 7,
  "postedDate": 1690000000,
  "url": "https://www.freelancer.com/projects/python/build-scraper",
  "matchedSkills": ["Python", "Scrapy"],
  "skillMatchCount": 2,
  "opportunityScore": 78.5
}

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

How the opportunity score works

The score sums transparent components (max 100):

Component	Max	Basis
Skill fit	40	Share of your requested skills the project needs.
Budget size	30	Higher upper budget scores higher (caps at ~2,000).
Low competition	20	Fewer existing bids scores higher.
Budget clarity	10	Both a minimum and maximum budget are specified.

Sources & configuration

• Freelancer.com — public read API (/api/projects/0.1/projects/active/); returns active, publicly listed projects.
• Environment variables — none required. Apify Proxy password is injected by the platform.

Local execution

pip install -r requirements.txt
# put input in storage/key_value_stores/default/INPUT.json
python src/main.py

Apify execution

Deploy with apify push, then run from the Console or via the API. Schedule it to surface fresh opportunities on a cadence.

Limitations & legal

• Only publicly listed project data is processed. No private client information is collected — no contact details, no client identities beyond what the public listing exposes.
• The opportunity score is a heuristic signal, not a guarantee — always read the project before bidding.
• Respect Freelancer.com's Terms of Service and applicable laws in your jurisdiction.