YepAPI/skills

Link Building

Endpoints Used

Endpoint	Cost	Purpose
POST /v1/seo/backlinks/summary	$0.03	Aggregate backlink metrics and dofollow ratio
POST /v1/seo/referring-domains	$0.03	Referring domains with authority scores
POST /v1/seo/backlinks	$0.05	Individual backlinks with anchor text and type

Rules

• Summary first: run POST /v1/seo/backlinks/summary on your domain and competitors — compare total backlinks, dofollow ratio, domain rank
• Referring domains: use POST /v1/seo/referring-domains to find high-authority domains linking to competitors but not to you
• Link intersection: run referring domains on 3-5 competitors, find domains that link to 2+ competitors — these are your highest-probability outreach targets
• DA/DR scoring: prioritize outreach to domains with DR 30+ — filter out spammy or irrelevant domains
• Anchor text analysis: use POST /v1/seo/backlinks to audit anchor text diversity — flag over-optimized anchors (>30% exact match)
• Outreach tracker: maintain a table with columns: target domain, contact email, status (prospecting, emailed, follow-up, won, lost), DA, date
• Monitor new/lost links: run backlink summary weekly, compare against previous snapshot — alert on significant drops

Outreach Dashboard Schema

CREATE TABLE outreach (
  id SERIAL PRIMARY KEY,
  target_domain TEXT NOT NULL,
  contact_email TEXT,
  status TEXT DEFAULT 'prospecting',
  domain_rank INTEGER,
  notes TEXT,
  last_contacted_at TIMESTAMP,
  created_at TIMESTAMP DEFAULT NOW()
);

Error Handling

• NO_CREDITS (402) — Tell the user to add credits at https://yepapi.com/dashboard
• UPSTREAM_ERROR (502) — Retry once; if it fails again, skip and note it
• RATE_LIMITED (429) — Wait and retry; respect the Retry-After header