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/dashboardUPSTREAM_ERROR (502) — Retry once; if it fails again, skip and note itRATE_LIMITED (429) — Wait and retry; respect the Retry-After header