whatpeoplepayfor

# WhatPeoplePayFor Agent-first market intelligence API for the gig economy. Monthly Fiverr dataset with 274 categories and 17,000+ gig snapshots, queryable via natural language or structured endpoints. ## Quick Start ### Install ```bash clawhub install whatpeoplepayfor ``` ### Configure Get your API key at [whatpeoplepayfor.com](https://whatpeoplepayfor.com): 1. Sign up with Google 2. Choose a plan (starts at $19.90/month, or $99.90 lifetime) 3. Copy your API key from the getting-started page Set the environment variable: ```bash export WPP_API_KEY="your_api_key_here" ``` ### Verify ```bash curl -s \ -H "Authorization: Bearer $WPP_API_KEY" \ "https://whatpeoplepayfor.com/api/agent/bootstrap" ``` You should see your access status, endpoint map, and available data months. ## What This Skill Does This skill gives your AI agent access to a monthly gig economy dataset. The agent can: - **Ask natural language questions** about market opportunities, trends, and demand - **Discover growth opportunities** across 274 freelance categories - **Analyze top orders** and revenue patterns - **Extract pain points** that customers repeatedly mention - **Track individual gigs** over time to spot trends - **Save and rerun analyses** monthly with the Focus system ## Authentication All requests require a bearer token: ``` Authorization: Bearer $WPP_API_KEY ``` ## API Base URL ``` https://whatpeoplepayfor.com/api/agent ``` ## Workflow ### 1. Bootstrap Always start here. Confirms your key works and returns the endpoint map. ```bash curl -s \ -H "Authorization: Bearer $WPP_API_KEY" \ "https://whatpeoplepayfor.com/api/agent/bootstrap" ``` ### 2. Ask (primary entrypoint) Turn natural language into structured market analysis: ```bash curl -s \ -X POST \ -H "Authorization: Bearer $WPP_API_KEY" \ -H "Content-Type: application/json" \ "https://whatpeoplepayfor.com/api/agent/ask" \ -d '{ "question": "What are the fastest-growing freelance categories this month?", "saveFocus": true }' ``` The response includes: - `run.answer.summary` — natural language answer - `run.answer.supportingOrders` — evidence data - `run.answer.topPainPoints` — demand signals - `run.answer.recommendedFollowups` — suggested next questions Example questions: - "Help me find the fastest-growing opportunity in March" - "What are the strongest orders behind that opportunity?" - "Which pain points repeat most often in business plans?" ### 3. Drill down with query endpoints After `ask` identifies a promising angle, use structured queries: **Available months:** ```bash curl -s -H "Authorization: Bearer $WPP_API_KEY" \ "https://whatpeoplepayfor.com/api/agent/query/months" ``` **Monthly stats:** ```bash curl -s -H "Authorization: Bearer $WPP_API_KEY" \ "https://whatpeoplepayfor.com/api/agent/query/stats?month=2026-03" ``` **Category rollups (sorted by revenue):** ```bash curl -s -H "Authorization: Bearer $WPP_API_KEY" \ "https://whatpeoplepayfor.com/api/agent/query/category-rollups?month=2026-03&sort=avg_revenue&limit=20" ``` **Search snapshots:** ```bash curl -s -H "Authorization: Bearer $WPP_API_KEY" \ "https://whatpeoplepayfor.com/api/agent/query/snapshots?month=2026-03&category_slug=business-plans&limit=20" ``` **Single snapshot detail:** ```bash curl -s -H "Authorization: Bearer $WPP_API_KEY" \ "https://whatpeoplepayfor.com/api/agent/query/snapshot?snapshot_id=<SNAPSHOT_ID>" ``` **Track a gig over time:** ```bash curl -s -H "Authorization: Bearer $WPP_API_KEY" \ "https://whatpeoplepayfor.com/api/agent/query/gig-history?gig_id=<GIG_ID>&limit=12" ``` **Aggregate pain points:** ```bash curl -s -H "Authorization: Bearer $WPP_API_KEY" \ "https://whatpeoplepayfor.com/api/agent/query/pain-points?month=2026-03&q=plan&limit=20" ``` ### 4. Focus system (save and rerun) Save useful analyses as durable Focuses that can be rerun against new monthly data: **List workspaces:** ```bash curl -s -H "Authorization: Bearer $WPP_API_KEY" \ "https://whatpeoplepayfor.com/api/agent/workspaces" ``` **List focuses in a workspace:** ```bash curl -s -H "Authorization: Bearer $WPP_API_KEY" \ "https://whatpeoplepayfor.com/api/agent/workspaces/<WORKSPACE_ID>/focuses" ``` **Rerun a focus:** ```bash curl -s -X POST \ -H "Authorization: Bearer $WPP_API_KEY" \ -H "Content-Type: application/json" \ "https://whatpeoplepayfor.com/api/agent/focuses/<FOCUS_ID>/run" \ -d '{}' ``` ### 5. SSE streaming (optional) For incremental row consumption: ```bash curl -N -H "Authorization: Bearer $WPP_API_KEY" \ "https://whatpeoplepayfor.com/api/agent/sse/category-rollups?month=2026-03" ``` ## Query Strategy - Prefer `ask` first for natural-language exploration, then drill down with query endpoints - Use `bootstrap` once per session to confirm access and discover available data - Use `stats` and `category-rollups` before scanning raw snapshots - Use `pain-points` when looking for demand themes and repeated customer signals - Use `snapshot` and `gig-history` only after narrowing candidates - Use `focuses` when the agent needs continuity across sessions ## Endpoint Map | Endpoint | Method | Purpose | |----------|--------|---------| | `/bootstrap` | GET | Discover endpoints and confirm access | | `/usage` | GET | Check API usage stats | | `/workspaces` | GET | List workspaces | | `/ask` | POST | Natural language market analysis | | `/workspaces/:id/focuses` | GET | List saved analyses | | `/focuses/:id` | GET | Read a saved analysis | | `/focuses/:id/run` | POST | Rerun a saved analysis | | `/query/months` | GET | Available data months | | `/query/stats` | GET | Monthly summary | | `/query/category-rollups` | GET | Category-level analytics | | `/query/snapshots` | GET | Search gig snapshots | | `/query/snapshot` | GET | Single snapshot detail | | `/query/gig-history` | GET | Track gig across months | | `/query/pain-points` | GET | Aggregate customer pain points | | `/sse/snapshots` | GET | Stream snapshots (SSE) | | `/sse/category-rollups` | GET | Stream category rollups (SSE) | ## Security - All data access requires a valid `WPP_API_KEY` - Requests are sent to `https://whatpeoplepayfor.com/api/agent` over HTTPS - No data is stored locally; all queries hit the remote API - Your API key is never logged or transmitted to third parties ## Common Errors | Error | Cause | Fix | |-------|-------|-----| | `401 Missing bearer token` | No Authorization header | Add `Authorization: Bearer $WPP_API_KEY` | | `401 Invalid API key` | Key not recognized | Check key at whatpeoplepayfor.com | | `403 Access inactive` | Payment expired or key revoked | Renew subscription | | `404 Focus not found` | Focus deleted or wrong user | List focuses first | ## Pricing | Plan | Price | Access | |------|-------|--------| | Monthly | $19.90/mo | Full API access | | Lifetime | $99.90 one-time | Full API access, forever | Sign up at [whatpeoplepayfor.com](https://whatpeoplepayfor.com)