Broken Links checks the image and media links a supplier sends for its products and emails you a CSV of the ones that didn't load. It runs in the background: you start it, keep working, and the file arrives when it's done.
Before you start
- You need the Premium plan or higher. A free trial includes it too.
- The Supplier list shows the suppliers you can reach, through our agent credentials or your own. Some suppliers, SanMar among them, only allow your own credentials; they show up once you've added yours.
- Users with the Customer Support role don't see this tool.
Scan a supplier
- In the dashboard menu, under Tools, click Broken Links.
- Pick a Format: Product Part URL or URLs Only.
- Pick a Supplier.
- Click Scan for Broken Links.
- When the email from the PSRESTful team arrives, download the CSV attached to it.
After step 4 the page says Request Submitted Successfully. The email goes to the address you log in with. How long the scan takes depends on how many products and images the supplier has.
How to read the CSV
The file is named after the supplier code, like HIT_broken_links.csv.
- Product Part URL has three columns,
Product ID,Part IDandurl. Pick it when you want to know which listings in your store are affected. - URLs Only has one column,
url. It's handy for forwarding to the supplier as is.
A file with only the header row means every link we checked loaded.
What counts as broken
We send each link a quick request and expect a plain OK answer within 10 seconds. Anything else goes in the CSV: a missing file, a server error, a timeout, and also a link that redirects somewhere else. Your browser follows redirects, so a few rows may open fine there. Open a couple before you send the list to the supplier.
What it doesn't cover
- Products with no images at all aren't in the file. The "Every product has images" check in Data Validation covers that.
- Products whose media we couldn't load during the scan are skipped, not listed.
- It scans up to 20,000 of the supplier's sellable products.
- Scans run when you start them. Nothing re-checks the links on a schedule, so run it again when you want a fresh list.
Each URL gets an HTTP HEAD request with a 10-second timeout. Only a 200 passes, and redirects aren't followed, so a 301 or 302 is reported as broken. The URLs are the ones GET /v1.1.0/suppliers/{supplier_code}/medias/{product_id} returns; see Media Content 1.1.0.