Import a file in the app
- Export a page-level backlink list from your tool. A list of linking domains or per-site counts has no linking-page URLs and can’t be imported.
- Open Import files, choose the website and drop the file.
- Check Linking page column and Points to column. Common header names are picked automatically. Choose the right column when a box is empty or wrong.
- Read the ready line, then choose Import N links. Use download next to the skipped count to see each skipped row and the reason.
source_url, target_url and an optional anchor.
What carries over
- Anchor text, first seen, last seen, nofollow and lost flags are kept when the file has them. These are your supplier’s observations, not checks AgentLinkOps ran.
- Other columns, such as authority scores or traffic, are kept as supplier fields, up to 32 columns per row. Values are cut at 256 characters, and column names longer than 64 characters are shortened or left out. Keep the original file, because the import is not a full copy of it.
- Blank flag cells stay unset in the app. The CLI preview reads a blank nofollow or dofollow cell as false, so drop a flag column you don’t trust before previewing.
Why a row is skipped
- The linking page or points to cell is empty, or isn’t a public web address.
- The points to URL is on another website. In the app, a subdomain of your website counts as another website.
- A date cell can’t be read as a date.
- The follow and nofollow columns disagree.
- The row is already on your disavow list.
- The same linking page and target appeared earlier in the file. Repeats count once.
Ahrefs
Use a backlinks export with one row per linking page.
Domain Rating, URL Rating and traffic columns stay as Ahrefs metrics. A referring-domains export has no linking-page URLs, so use the backlinks report instead.
Semrush
Use the Backlinks report export for your domain or page.
Authority and toxicity columns stay as Semrush fields. Compare two Semrush files only when both cover the same scope: a root-domain export and a single-page export give different totals even when no link changed.
Majestic
Use a backlinks export, not a referring-domains summary.
Trust Flow and Citation Flow stay as Majestic metrics. Historic index rows can be old, so check a link before you treat it as live. In the app, Majestic dates and flags are kept as supplier fields. The CLI preset reads them as dates and flags. Check a file with a generic
Date column before you rely on it.
Moz
Use a Link Explorer export of inbound links by linking page.
Domain Authority and Page Authority stay as Moz metrics. Keep the target page column so links to different pages on your site stay separate.
Google Search Console
Export the linking pages list from the Links report. The Top linking sites and Top linked pages exports count links per site or per page and contain no linking-page URLs, so they can’t be imported.
Many Search Console exports have no target column. In the app, leave Points to column on your website (whole site). In the CLI, the
--target domain fills it. That target is your expectation, because Google didn’t say which page the link points to. Search Console shows a sample of links Google knows about, not every backlink, and it has no anchor or nofollow column.
Bing Webmaster Tools
Use a backlinks export from Bing Webmaster Tools. If you have connected Bing under Settings › Search connections, you can review the backlinks Bing reports in Find backlinks without a file.DataForSEO
Use a CSV with one backlink per row.dofollow runs the opposite way to nofollow: true means the supplier did not mark the link nofollow. The importer reads flat rows, so convert a nested JSON API response to CSV first and keep the original response.
Linkody
Use the backlinks export from your Linkody domain.
In the app, choose
URL as the linking page column and Link as the points to column. Linkody’s dates come from its own monitoring, not from checks AgentLinkOps ran. The CLI preset reads a Follow column as a nofollow flag, so true in that column would mark the link nofollow. Convert it to a Nofollow column with true or false values before you import.
CSV
Any CSV, TSV or spreadsheet export works if each row has a linking page and the page it points to. Name the columnsSource URL and Target URL and the app picks them up. With other names, choose the two columns yourself in the app, or pass --map in the CLI.
Quote cells that contain commas, such as anchor text. A spreadsheet that splits a quoted cell into extra columns gives that row the wrong number of values, and the row is skipped.
Preview a file with the CLI
The CLI reads the whole file and reports accepted, rejected and duplicate rows with their line numbers. It needs no account and saves nothing.ahrefs, semrush, majestic, moz, google_search_console, bing_webmaster_tools, dataforseo, linkody or csv. A preset only supplies default column names. When a header differs, name the columns:
csv preset has no default columns, so it always needs --map. Add --generated-at with the time your supplier produced the export. If the CLI can’t find a column, it prints the headers it saw and an example --map. The import command reference lists every flag, and import_backlinks covers hosted imports through MCP or HTTP.