← All posts

What You Can Build With the Vibeworker API

Every Vibeworker subscription includes full API access. Your scored, ranked Upwork job feed is available as a REST API — queryable, filterable, and composable with any tool that speaks HTTP.

Here's what that actually unlocks.

Your Morning Briefing in One Command

The simplest thing you can do with the API is replace your morning Upwork browse with a single terminal command:

curl -s "https://tryvibeworker.com/api/v1/jobs?limit=5&sort=match&minScore=0.75" \
  -H "Authorization: Bearer vw_YOUR_KEY" | jq '.data[] | {title, similarity, budget}'

Five best-matched jobs from overnight, in your terminal, in two seconds. No browser, no scrolling, no algorithmic feed deciding what you should see.

n8n / Zapier / Make Automations

Webhooks are the high-leverage integration. Register a webhook endpoint and Vibeworker will POST to it the moment a job scores above your threshold — typically within 60 seconds of it appearing on Upwork.

From there you can build whatever workflow makes sense for you:

  • Post to Slack — matched job arrives in a channel, you click the Upwork link and apply
  • Add to a Notion database — every matched job logged with score, budget, and client data
  • Email digest — collect matches throughout the day, send a single evening summary
  • Filter by budget and auto-draft — only jobs over $500 trigger a proposal draft

The webhook payload includes the full job object: title, description, budget, client history (spend, hire rate, payment verified), and all four match scores. Everything you need to decide whether to act — without opening Upwork.

{
  "event": "job.matched",
  "job": {
    "title": "Build a Next.js dashboard",
    "budget": 800,
    "scores": { "match": 0.91, "quickWin": 8, "scopeClarity": 9, "redFlags": 9 },
    "client": { "totalSpent": 48000, "hireRate": 82, "paymentVerified": true },
    "upworkUrl": "https://www.upwork.com/jobs/~..."
  }
}

Every request is signed with HMAC-SHA256 so you can verify it actually came from Vibeworker.

AI Proposal Drafting with Any LLM

The /proposal-context/:id endpoint returns everything an AI needs to write a strong proposal in one shot:

  • Full job description
  • Client history (spend, hire rate, verification status)
  • All four match scores with reasoning
  • Your profile text and experience
  • A system prompt with proposal-writing instructions

Pass the response directly to GPT-4, Claude, Gemini, or whatever model you prefer:

CONTEXT=$(curl -s "https://tryvibeworker.com/api/v1/proposal-context/~01234abcdef" \
  -H "Authorization: Bearer vw_YOUR_KEY")

# Feed to your LLM of choice

The proposal context is designed to produce specific, non-generic proposals — it includes the job's scope clarity score and red flags so the model knows what to address and what to avoid.

Build a Custom Job Dashboard

If the Vibeworker dashboard doesn't fit your workflow, build your own. The /jobs endpoint gives you your full scored feed with all the data you need to render whatever UI you want:

  • Match score and percentile
  • Per-dimension similarity (skills, scope, client, risks)
  • Quick Win score
  • Full client history
  • Job status (new / viewed / dismissed)

Some freelancers build simple HTML files they open in a browser. Others pipe jobs into a spreadsheet. The data is yours.

Category Market Research

The search endpoint lets you query jobs by keyword across the last 48 hours — independent of your personal match scores. Useful for:

  • Scoping a new niche — how many React jobs posted in the last 48h? What are the typical budgets?
  • Monitoring competitors — which categories are heating up?
  • Finding outliers — search for a niche skill and see what the market actually pays
curl -s "https://tryvibeworker.com/api/v1/search?q=webflow&limit=20" \
  -H "Authorization: Bearer vw_YOUR_KEY" | jq '.data | length'

RSS Into Every Tool That Supports It

The RSS feed is a simpler entry point for tools that already understand RSS natively. Zapier, n8n, and Make all have RSS triggers — you can pipe your scored feed into any automation without writing a line of code or managing webhooks.

The feed URL works anywhere a URL works: RSS readers, automation platforms, monitoring tools, even some email clients.

Getting Started

All of this is included in your existing subscription. Generate an API key in Settings → API, then check the API reference for full endpoint documentation.


Vibeworker is free for 7 days. API access, webhooks, RSS feed, and proposal context included at every tier. Start your free trial →


Michael Watkins

Michael Watkins

Founder of Vibeworker. Helping freelancers win the Upwork game through speed and data.

Stop missing the jobs that matter

Vibeworker watches the Upwork feed and alerts you the moment a high-fit job appears — before the proposals pile up.

Start free trial →