sales-skills/sales-buysellads
skills/sales-buysellads/SKILL.md
BuySellAds platform help — contextual advertising marketplace for websites, newsletters, and podcasts with Ad Serving API, Advertiser API, JS Monetization Framework, Carbon Ads, and Zapier triggers. Use when newsletter ads aren't filling or revenue is low on BuySellAds, ad serving API returns empty responses, Advertiser API stats don't match dashboard numbers, integrating BuySellAds ads into your ESP newsletter template, setting up Carbon Ads for a developer-focused site, or comparing BuySellAds commission rate to alternatives like Paved or LiveIntent. Do NOT use for general newsletter monetization strategy (use /sales-newsletter) or finding sponsors via intelligence databases (use /sales-sponsorgap or /sales-whosponsorsstuff).
$ install --global
skillsauthnpx skillsauth add sales-skills/sales sales-buyselladsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 14, 2026, 2:05 AM36.5s4 files scanned
SKILL.md
- name:
- sales-buysellads
- description:
- BuySellAds platform help — contextual advertising marketplace for websites, newsletters, and podcasts with Ad Serving API, Advertiser API, JS Monetization Framework, Carbon Ads, and Zapier triggers. Use when newsletter ads aren't filling or revenue is low on BuySellAds, ad serving API returns empty responses, Advertiser API stats don't match dashboard numbers, integrating BuySellAds ads into your ESP newsletter template, setting up Carbon Ads for a developer-focused site, or comparing BuySellAds commission rate to alternatives like Paved or LiveIntent. Do NOT use for general newsletter monetization strategy (use /sales-newsletter) or finding sponsors via intelligence databases (use /sales-sponsorgap or /sales-whosponsorsstuff).
- argument-hint:
- [describe your BuySellAds question — ad serving, publisher setup, API integration, or campaign stats]
- license:
- MIT
- version:
- 1.0.0
- tags:
- [sales, newsletter, advertising, platform]
- github:
- https://github.com/buysellads
BuySellAds Platform Help
Step 1 — Gather context
If references/learnings.md exists, read it first for accumulated platform knowledge.
Ask the user:
-
Are you a publisher or advertiser?
- A) Publisher — monetizing my website, newsletter, or podcast with ads
- B) Advertiser — running campaigns to reach specific audiences
- C) Developer — integrating the Ad Serving API or Monetization Framework
-
What do you need help with?
- A) Setting up ad zones and integrating ad code
- B) Email/newsletter ad integration (ESP template setup)
- C) Advertiser API — pulling campaign stats programmatically
- D) Low fill rate / no ads showing / revenue optimization
- E) Carbon Ads or Coin.Network sub-network setup
- F) Zapier automation (deal triggers, spot sold notifications)
-
Current setup (if applicable):
- Platform type (website, newsletter, podcast)
- Current ESP (if newsletter)
- Traffic/subscriber count
Skip-ahead rule: if the user's prompt already contains enough context, skip to Step 2.
Step 2 — Route or answer directly
| If the question is about... | Route to... |
|---|---|
| Newsletter monetization strategy (not BSA-specific) | /sales-newsletter [question] |
| Finding sponsors to pitch | /sales-sponsorgap [question] or /sales-paved [question] |
| Email deliverability | /sales-deliverability [question] |
| Newsletter sponsorship operations | /sales-sponsy [question] |
| Email marketing campaigns | /sales-email-marketing [question] |
When routing, provide the exact command: "This is a {problem domain} question — run: /sales-{skill} {user's original question}"
Step 3 — BuySellAds platform reference
Read references/platform-guide.md for the full platform reference — capabilities, pricing, data model, APIs, integration recipes, code examples.
Answer the user's question using only the relevant section. Don't dump the full reference.
Step 4 — Actionable guidance
For publishers:
- Start with the Monetization Framework (JS) for websites — lowest setup effort
- For newsletters, use the Ad Serving API with your ESP's template system
- Set floor CPMs conservatively, then raise as demand increases
- Use both self-serve marketplace AND managed sales for maximum fill rate
For advertisers:
- Use the Advertiser API to pull daily stats into your analytics pipeline
- Filter by
startDate/endDateto avoid pulling all-time data - Export to CSV with
type=csvfor quick reporting
For developers:
- Always check for
statlinkbefore rendering — missing means no ad available - Use
ignore=yesparameter during development to avoid counting test impressions - Handle the pixel tracking array (split on
||, replace[timestamp])
If you discover a gotcha, workaround, or tip not covered in references/learnings.md, append it there.
Gotchas
Best-effort from research — review these, especially items about plan-gated features and integration gotchas that may be outdated.
- 25% commission on managed sales — BuySellAds takes 25% of each ad sale (publisher keeps 75%). Self-serve shopping cart reduces this to 15% (publisher keeps 85%).
- No guaranteed fill rate — BuySellAds does not guarantee any fill rate. Niche sites with low traffic may see significant unsold inventory.
- API key requires account manager — you cannot self-generate an API key. Contact your account manager or [email protected].
- Click discrepancy is common — advertisers report Google Analytics showing fewer clicks than BSA dashboard. Use UTM parameters and compare carefully.
- Wire transfer minimum $500 with $35 fee — PayPal is available but also has fees. Factor payout costs into your revenue calculations.
- Email integration only documented for Buttondown — other ESPs require custom implementation using the Ad Serving API JSON endpoint.
- Advertiser API is read-only — you can pull stats but cannot create or modify campaigns via API.
Related skills
/sales-newsletter— Newsletter monetization strategy (paid subscriptions, sponsorships, ad sales, pricing)/sales-paved— Paved newsletter sponsorship marketplace (alternative ad network and marketplace)/sales-sponsy— Sponsy sponsorship operations (ad inventory, sponsor CRM, reporting)/sales-sponsorgap— SponsorGap sponsor intelligence (find brands sponsoring newsletters)/sales-whosponsorsstuff— Who Sponsors Stuff sponsor intelligence (ad creative tracking)/sales-hecto— Hecto self-serve newsletter advertising marketplace/sales-do— Not sure which skill to use? The router matches any sales objective to the right skill. Install:npx skills add sales-skills/sales --skill sales-do
Examples
Example 1: Newsletter ad integration
User says: "How do I integrate BuySellAds ads into my Beehiiv newsletter?" Skill does: Reads platform-guide.md for Ad Serving API details, explains the JSON endpoint pattern with zone key, shows how to fetch ad data server-side and insert into ESP template, notes that only Buttondown has documented native integration Result: User has working code to fetch and render BSA ads in their newsletter template
Example 2: Campaign stats pipeline
User says: "I want to pull my BuySellAds campaign stats into a spreadsheet daily"
Skill does: Reads platform-guide.md for Advertiser API endpoints, provides cURL and Python examples for /daily-stats, shows CSV export option with type=csv, suggests Zapier trigger for automation
Result: User has a working script to export campaign performance data
Example 3: Low ad revenue
User says: "My BuySellAds revenue is way lower than what I made with AdSense" Skill does: Explains contextual vs programmatic model differences, reviews CPM optimization (floor pricing, niche targeting, multiple ad zones), recommends combining BSA with other monetization (direct sponsors via Paved, paid recommendations via SparkLoop) Result: User has a multi-channel monetization strategy instead of relying solely on BSA
Troubleshooting
Ads not showing / empty responses
Symptom: Ad Serving API returns empty ads array or no statlink field
Cause: No ads available for your zone, or zone not approved yet, or using wrong zone key
Solution: Test with zone key CVADC53U (BSA test zone). Check your zone is active in the dashboard. Implement fallback content for when no ads are available. Use ignore=yes to test without counting impressions.
Click count mismatch between BSA and Google Analytics
Symptom: BSA dashboard shows 250 clicks but GA shows only 75 Cause: Bot traffic, ad blockers, redirects dropping UTM parameters, or BSA counting redirects before page load Solution: Add UTM parameters to all ad links. Compare BSA clicks vs GA sessions with UTM source=buysellads. Report significant discrepancies to [email protected].
Revenue dropped after changing floor CPM
Symptom: Raised floor CPM and now ads aren't filling Cause: Floor price exceeds what advertisers are willing to pay for your inventory Solution: Lower floor CPM gradually. BuySellAds does not auto-optimize — you must manually adjust. Start low and increase in small increments. Monitor fill rate after each change.
Related Skills
sales-skills/sales-upviral
tools
VerifiedTrustedCommunity
UpViral platform help — viral referral marketing and list-building platform (by Emarky) for viral sweepstakes, giveaway/reward campaigns, pre-launch waiting lists, and milestone referral programs, with REST API (app.upviral.com/api/v1/), callback-URL webhooks, PHP SDK, fraud detection (IP-based suspicious-referral flagging), A/B testing, smart leaderboards, unlockable incentives, and 30+ native ESP/CRM integrations (Mailchimp, ActiveCampaign, ConvertKit, AWeber, HubSpot, Klaviyo, Intercom) plus Zapier/Make/Pipedream/Integrately/Pabbly. Use when UpViral campaigns aren't tracking referral points correctly, deciding between Starter $79/mo annual (10K leads, 1 brand, NO API) vs Business $119/mo (25K, 2 brands, API + webhooks unlocked) vs Premium $319/mo (100K, 5 brands, dedicated account manager), the API returns errors because you're on the Starter tier where API/webhooks are gated, building an UpViral→CRM or UpViral→data-warehouse pipeline with add_contact / get_leads / get_leads_points / add_points / get_custom_fields / lists methods (uvapikey + uvmethod form-encoded POST), interpreting fraud flags where same-IP referrals get marked suspicious and you must manually activate/delete/blacklist, setting up the Callback URL (webhook) to fire on reward-unlock events, Zapier New Lead / New Reward Unlocked triggers not firing, ClickFunnels/Shopify/funnel-builder integration breaking, the drag-and-drop page builder showing broken widgets or limited customization, the setup feeling long and complicated for your first campaign, or picking UpViral over Viral Loops / KickoffLabs / Vyper / Prefinery / Gleam / KingSumo / ShortStack for a viral campaign. Do NOT use for general newsletter audience growth strategy across all platforms (use /sales-audience-growth), newsletter monetization (use /sales-newsletter), KickoffLabs-specific help (use /sales-kickofflabs), no-code merge-tag newsletter referrals (use /sales-referralkit), SparkLoop paid recommendations (use /sales-sparkloop), or full-stack multi-level Level-1/2/3 referral/affiliate tracking (use /sales-referralhero).
39SKILL.mdUpdated Jun 4, 2026
sales-skills/sales-referralhero
development
VerifiedTrustedCommunity
ReferralHero platform help — full-stack referral, affiliate, waitlist, contest, and NPS platform with subscriber API, webhooks, Zapier, Mailchimp/Kit/AWeber/Klaviyo/ActiveCampaign/SendLane connectors, coupon codes, multi-level referral tracking (Level 1/2/3), anti-fraud, and 5,000 calls/hour rate limit. Use when ReferralHero campaigns aren't tracking referrals correctly, deciding between PRO $199/mo (10K members, includes API + webhooks) and PREMIUM $399/mo (50K members, adds ReCaptcha + SMS verification), authentication is failing with no_token or X-API-Key header is being ignored, multi-level referral counts (Level 2/3) aren't appearing for downline subscribers, coupon group endpoints return 404 or coupon arrays max out, hitting the 5,000 calls/hour soft limit and getting too_many_calls 429s, the Mailchimp/Kit native integration is double-adding subscribers, webhook payloads aren't firing on confirmation events, importing Stripe customer IDs through transaction tracking, generating reward fulfillment when subscribers cross milestone thresholds (promote/unlock_promoted_reward), comparing ReferralHero against SparkLoop/ReferralKit/Viral Loops/GrowSurf/KickoffLabs for referral marketing, or routing referral data via add_bulk_transactions (500-transaction batch limit). Do NOT use for general newsletter audience growth strategy (use /sales-audience-growth), general newsletter monetization (use /sales-newsletter), no-code newsletter-only referral with merge-tag insertion (use /sales-referralkit), SparkLoop's paid recommendations or partner network (use /sales-sparkloop), or affiliate program strategy across many platforms (use /sales-affiliate-program).
39SKILL.mdUpdated Jun 4, 2026
sales-skills/sales-kickofflabs
tools
VerifiedTrustedCommunity
KickoffLabs platform help — viral marketing platform for pre-launch waitlists, bonus-entry giveaways, milestone-reward referral programs, leaderboard giveaways, and email opt-in bribes with REST API v1 + v2, server-side webhooks (in/out), KOL.js JavaScript library, AnyForm script for custom pages, fraud detection (duplicate_ip / bounced / duplidate_email flags), SMS verification add-on, native ESP integrations (Klaviyo, Mailchimp, ActiveCampaign, Brevo), website builders (Webflow, Wix, Squarespace, Weebly), Shopify, Facebook Audiences, Slack, Zapier. Use when KickoffLabs viral campaigns aren't tracking referrals correctly, deciding between Hobby $13/mo annual (500 leads/mo no A/B no reward emails) vs Premium $48/mo (2.5K + A/B + reward emails + tracking pixels) vs Business $99/mo (10K + custom email templates + custom domains + advanced reporting + 3 team) vs Enterprise $202/mo (25K + 5 team + SMS included), API key getting rejected because you embedded it in client-side JavaScript instead of server-side, can't decide whether to use v1 /subscribe vs v2 /tags/:TAG_ID/lead for lead creation, webhook payloads firing with `__fraudulent` flag and you need to interpret the duplicate_ip/bounced/duplidate_email reason codes (yes, duplidate is spelled that way in their docs), AnyForm script not posting to KickoffLabs vs native API endpoint, leaderboard endpoint returning more than 50 leads is not allowed, social_id (kid in share URLs) attribution chain breaking between v1 and v2, contest score vs lead count metrics in the webhook payload are confusing, SMS Verification only available on Premium+ as $50/mo add-on (Enterprise includes), per-month lead cap auto-upgrades at $8 per 1000 overage leads, picking between KickoffLabs and Viral Loops / UpViral / Prefinery / ReferralCandy / Voucherify for viral campaign type fit, or rate limit per tier (10-100 calls/minute) is hitting on bulk imports. Do NOT use for general newsletter audience growth strategy (use /sales-audience-growth), general newsletter monetization (use /sales-newsletter), no-code merge-tag-only newsletter referrals (use /sales-referralkit), SparkLoop paid recommendations + partner network (use /sales-sparkloop), or full-stack referral/affiliate with multi-level Level-1/2/3 tracking (use /sales-referralhero).
39SKILL.mdUpdated Jun 4, 2026
sales-skills/sales-do
development
VerifiedTrustedCommunity
Routes any sales, marketing, ad, or GTM objective to the right specialized skill and outputs the install command for that skill plus a ready-to-paste prompt packed with the user's context. Asks clarifying questions when the objective is ambiguous, then hands back a copy-paste-runnable next step. Covers prospecting, outbound cadences, deals, proposals, forecasting, deliverability, enrichment, intent, content, coaching, CRO, SEO, launch directories, newsletters, email/SMS/push marketing, chatbots, influencer marketing, social media, employee advocacy, media relations, reviews, data hygiene, B2B advertising, retargeting, affiliate, loyalty, digital products, memberships, webinars, checkout, and platform-specific help. Use when the user has a sales or marketing question and isn't sure which skill to use, or wants a multi-skill sequence with a batch install command. Do NOT use to solve problems directly — this skill only routes.
39SKILL.mdUpdated Apr 24, 2026