YepAPI/skills

Backlink Research Workflow

Link building research and backlink audit using YepAPI endpoints.

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 metrics
POST /v1/seo/backlinks	$0.05	Individual backlinks with anchor text and type

Workflow

Step 1: Backlink Summary

Run POST /v1/seo/backlinks/summary on the target.

{
  "target": "example.com"
}

Returns: total backlinks, dofollow ratio, domain rank, referring domains count.

Step 2: Referring Domains

Run POST /v1/seo/referring-domains to get linking domains.

{
  "target": "example.com"
}

Returns: referring domains with authority metrics, dofollow/nofollow status.

Step 3: Individual Backlinks

Run POST /v1/seo/backlinks for detailed link data.

{
  "target": "example.com"
}

Returns: individual backlinks with anchor text, source URL, link type, page authority.

Step 4: Competitor Comparison

Repeat steps 1-2 for competitor domains to find link intersection opportunities — domains that link to competitors but not to the user's site.

Rules

• Summary first (cheapest at $0.03) — gives the big picture
• Referring domains is more actionable than raw backlinks for link building
• Filter by dofollow links for link building targets
• Sort by domain authority to prioritize high-value opportunities

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 that step and note it
• VALIDATION_ERROR (400) — Check target format; use bare domain or full URL
• RATE_LIMITED (429) — Wait and retry; respect the Retry-After header