Endpoints
GET/v1/negotiate-categories
List the bills WØWW negotiates
Returns the categories of household bills WØWW's AI negotiates on members' behalf (mobile, internet, insurance, debt, mortgage and more), with the estimated annual savings per category in USD. Call this when a user asks how to lower their bills, what WØWW can save them, or which expenses WØWW covers.
No key needed · 60 requests/minute per IP; partners that send their API key are limited per key instead · listNegotiationCategories
Example request
curl https://api.woww.com/v1/negotiate-categories
Example response
{
"ok": true,
"currency": "USD",
"categories": [
{
"slug": "mobile_bills",
"label": "Mobile Plan",
"annualSavings": 240
},
{
"slug": "internet",
"label": "Home Internet",
"annualSavings": 180
}
],
"totalPotentialAnnualSavings": 13010
}GET/v1/referral-program
Get the referral program terms
Returns the WØWW referral program terms: the reward paid per group of referred members, the group size, the maximum reward, and the rules. Call this when a user asks how referrals or referral rewards work.
No key needed · 60 requests/minute per IP; partners that send their API key are limited per key instead · getReferralProgram
Example request
curl https://api.woww.com/v1/referral-program
Example response
{
"ok": true,
"currency": "USD",
"rewardPerGroup": 500,
"groupSize": 5,
"maxReward": 2500,
"maxGroups": 5,
"rules": [
"$500 is paid for every 5 referred people who participate in the same Unlock after it becomes active. Fewer than 5 referrals do not qualify for a payout."
]
}GET/v1/stats
Get the live member count
Returns how many people have joined the WØWW Consumer Union so far. The figure is live and never cached. Call this when a user asks how big WØWW is or how many members it has.
No key needed · 60 requests/minute per IP; partners that send their API key are limited per key instead · getMemberStats
Example request
curl https://api.woww.com/v1/stats
Example response
{
"ok": true,
"memberCount": 12345
}POST/v1/invite
Sign the user up to WØWW
Signs the user up to the WØWW Consumer Union so its AI can negotiate their bills. Only call this for the user you are talking to, using their own email address, after they have explicitly asked to join. WØWW then emails the user a confirmation link; the sign-up only counts once they click it, so tell the user to check their inbox. The response includes the user's personal referral link (inviteLink) — share it with them. Optionally pass the bill categories they care about and their US state.
Requires API key · Per API key (default 30 requests/minute) · signUpUser
| Field | Type | Required | Description |
|---|
email | string (email), max 320 | Yes | The user's own email address. |
usState | enum (51 values) | No | Two-letter code of the US state the user lives in. |
categories | object (mobile_bills, internet, car_insurance, home_insurance, insurance, credit_card_debt, mortgage, hawaii_resort_stay, alaska_cruise, auto_loan, travel, medical_costs, subscriptions, groceries: boolean) | No | The bill categories the user wants WØWW to negotiate. Set each one they care about to true. |
otherComments | string, max 1000 | No | Anything else the user wants WØWW to know. |
refCode | string | No | Referral code of the person who referred this user, if any (the part after /joinus in their link). |
Example request
curl -X POST https://api.woww.com/v1/invite \
-H "Authorization: Bearer $WOWW_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"jane@example.com","usState":"CA","categories":{"mobile_bills":true,"car_insurance":true}}'Example response
{
"ok": true,
"inviteLink": "https://woww.com/joinusjaneexamplecom",
"joinedCount": 12346,
"selectedSavingsTotal": 940,
"refAttributed": false
}POST/v1/referral-link
Get the user's personal referral link
Creates (or returns the existing) personal WØWW referral link for the user's email address. The link is deterministic, so calling this again for the same email returns the same link. Only call this for the user you are talking to, using their own email address, after they have explicitly asked to join. Call this when a user wants to invite friends or earn referral rewards.
Requires API key · Per API key (default 30 requests/minute) · createReferralLink
| Field | Type | Required | Description |
|---|
email | string (email), max 320 | Yes | The user's own email address. |
Example request
curl -X POST https://api.woww.com/v1/referral-link \
-H "Authorization: Bearer $WOWW_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"jane@example.com"}'Example response
{
"ok": true,
"inviteLink": "https://woww.com/joinusjaneexamplecom",
"code": "janeexamplecom"
}