skills/sales-reletter/SKILL.md
Reletter platform help — newsletter search engine indexing 7M+ publications with subscriber data, creator contacts, engagement metrics, keyword monitoring, Python SDK, CLI, MCP server, and REST API. Use when you need to find newsletters to sponsor but don't know where to start, want contact info for newsletter creators for PR or partnerships, need to monitor when your brand gets mentioned in newsletters, looking for newsletters in a specific niche with audience size data, want to build a target list of newsletters for sponsorship outreach, or need to search newsletters programmatically via API or MCP. Do NOT use for general newsletter monetization strategy (use /sales-newsletter) or newsletter sponsorship marketplace transactions (use /sales-paved).
npx skillsauth add sales-skills/sales sales-reletterInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
If references/learnings.md exists, read it first for accumulated platform knowledge.
What are you trying to do?
What's your current setup?
Skip-ahead rule: if the user's prompt already contains enough context, skip to Step 2.
| Problem domain | Route to |
|---|---|
| Newsletter monetization strategy (pricing tiers, paid subs vs ads, revenue models) | Run: /sales-newsletter {user's question} |
| Newsletter sponsorship marketplace (buying/selling placements, programmatic ads) | Run: /sales-paved {user's question} |
| Email marketing campaigns, automation, segmentation | Run: /sales-email-marketing {user's question} |
| Growing newsletter subscriber list | Run: /sales-audience-growth {user's question} |
| Social listening / brand monitoring across social media | Run: /sales-social-listening {user's question} |
When routing to another skill, provide the exact command.
Read references/platform-guide.md for the full platform reference — search capabilities, contact intelligence, list building, monitoring, pricing tiers, API endpoints, Python SDK, CLI, MCP server, and integration recipes.
Answer the user's question using only the relevant section. Don't dump the full reference.
You no longer need the platform guide — focus on the user's specific situation.
For sponsorship prospecting: Start with topic search + subscriber filter (5K+ minimum for most sponsors). Export to a list, enrich with contacts, then pitch directly or route through Paved for marketplace-mediated deals.
For PR/partnerships: Search by topic, filter by engagement, pull creator contacts. Cross-reference with the newsletter's content to personalize outreach.
For brand monitoring: Set up keyword alerts for your brand name, product names, and competitors. Review mentions to identify organic coverage opportunities.
For developers: Use the Python SDK or MCP server for bulk operations. The API is best for building newsletter discovery into your own tools or automating list building.
If you discover a gotcha, workaround, or tip not covered in references/learnings.md, append it there.
Best-effort from research — review these, especially items about plan-gated features and integration gotchas that may be outdated.
mcp.reletter.com needs authentication. Set RELETTER_API_KEY before connecting./sales-newsletter — Newsletter monetization strategy (paid subscriptions, sponsorships, pricing, premium tiers)/sales-paved — Paved platform help (newsletter sponsorship marketplace, Ad Network, Booker, Radar)/sales-sparkloop — SparkLoop platform help (referral programs, paid recommendations, partner programs)/sales-audience-growth — Growing your subscriber list/sales-email-marketing — Email marketing strategy (campaigns, automation, segmentation)/sales-media-relations — Media relations and PR outreach/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-doUser says: "I want to find AI newsletters with 10K+ subscribers to sponsor" Skill does: Guides through Reletter topic search with subscriber filters, explains how to evaluate engagement metrics, recommends building a shortlist of 10-15 newsletters, then exporting with contacts for direct outreach or routing to Paved for marketplace deals Result: User has a curated list of target newsletters with contact info and a sponsorship outreach plan
User says: "How do I use the Reletter API to search for fintech newsletters and pull their contact info?"
Skill does: Shows Python SDK setup (pip install reletter), demonstrates search.publications() with topic and subscriber filters, shows contacts.get() for pulling creator emails, explains pagination with iter_publications(), and covers error handling
Result: User has working Python code to programmatically discover and contact newsletter creators
User says: "I want to know every time my product gets mentioned in a newsletter" Skill does: Walks through Reletter's keyword alert setup, explains monitoring limits per plan tier, recommends setting alerts for brand name + product name + common misspellings, suggests reviewing mentions weekly for organic PR opportunities Result: User has newsletter brand monitoring configured with alerts
Symptom: Searching for a niche topic returns only a handful of newsletters Cause: Search query too specific, or niche genuinely underserved Solution: Broaden the search terms. Try related keywords. Use AI Search for semantic matching instead of exact keyword search. Check if the platform indexes the newsletter platform your targets use.
Symptom: Exported a list but many entries have no contact email Cause: Not all newsletter creators have publicly available email addresses Solution: Check the newsletter's publication page on Reletter for social media links as alternative contact methods. For high-priority targets, look up the creator on LinkedIn or their personal website.
Symptom: Python SDK raises RateLimitError during bulk operations
Cause: Exceeded the 5,000 requests/month API quota or hit per-minute rate limits
Solution: The SDK has automatic retries with exponential backoff (default 2 retries). For bulk operations, use iter_publications() which handles pagination automatically. Monitor usage with client.account.quota(). If consistently hitting limits, contact Reletter about higher-volume API access.
tools
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).
development
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).
tools
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).
development
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.