Skip to main content
Preview a supplier or CSV import.

​
Example

Previews the supplied CSV mapping, accepted candidates and rejection reasons. It writes no ledger or cloud records.

​
Options

  • FILE required
  • --target DOMAIN required
  • --from SUPPLIER defaults to csv
  • --map source=COL,target=COL
  • --exact-url changes target interpretation to exact_url
  • --no-subdomains excludes subdomains
  • --generated-at ISO records supplier time
  • --json. Supported presets: ahrefs, semrush, majestic, moz, dataforseo, linkody, google_search_console and csv. Explicit map fields: source, target, anchor, first_seen, last_seen, nofollow, dofollow, lost, link_type and supplier_row_id.

​
Exit status

0 on success; 2 on usage, configuration, input or request failure.

​
What happens

Writes no ledger or cloud data. Text output lists mapping, counts and rejection reasons. --json prints a JSON string containing newline-separated candidate objects; decode that string before treating its contents as JSONL.
Read configuration and file ownership for environment variables, compatibility aliases and writer locks. Read local file contracts for artifact fields. Browse the CLI index for related commands.
Check the selected environment and workspace access before calling hosted operations. See capability status.