Backlink Research Agent Skill
Link building research and backlink audit using YepAPI.
The Skill
Full content, every format. Copy it, download it, or install with one command.
---
description: Link building research and backlink audit using YepAPI.
homepage: https://yepapi.com/skills/backlink-research
metadata:
tags: [yepapi, seo, backlinks, link-building]
---
# 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.
```json
{
"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.
```json
{
"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.
```json
{
"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` headerInstall
Why Use the Backlink Research Skill?
Without this skill, your AI guesses at backlink research patterns. It might hallucinate deprecated APIs, use outdated conventions, or miss best practices entirely. With it, your AI follows a proven ruleset — every suggestion aligns with current standards.
Drop this skill into your project and your AI instantly knows the rules. Better code suggestions, fewer errors, faster shipping. This skill also teaches your AI how to call YepAPI endpoints for real data — keyword metrics, SERP results, backlinks, or whatever this workflow needs.
Try These Prompts
These prompts work better with the Backlink Research skill installed. Your AI knows the context and writes code that fits.
"Build a backlink audit tool that analyzes link quality and identifies toxic backlinks using YepAPI"
"Create a competitor backlink comparison dashboard with domain authority scores"
"Set up automated backlink monitoring that alerts when you gain or lose links"
Works Great With
Backlink Research skill — FAQ
It connects to YepAPI to analyze backlink profiles, identify toxic links, and audit link quality. Your AI builds backlink research tools with domain authority scoring and competitive comparisons.
Run `npx skills add YepAPI/skills --skill backlink-research` in your project root. This copies the skill file into your repo where your AI coding tool can read it automatically.
The skill uses YepAPI to fetch backlink profiles and includes scoring rules for link quality. It flags links from spammy domains, paid link networks, and irrelevant sites for disavow consideration.