Items Cleaner About

Items Cleaner turns messy retail product descriptions into a category, a subcategory and a brand. Give it a taxonomy and it only ever answers from your list; give it nothing and it works the categories out itself.

Why it exists

Most people holding a pile of messy product descriptions do not have a taxonomy yet — working out what the categories should be is half the job. So it does both: give it your list and it stays inside it, give it nothing and it proposes its own.

Nothing to install: whatever calls this service sends one item — a description, a barcode, or both — gets its category back, and holds one access token — no other key or account.

What you send and get back

You send one item per call: its descriptions, as messy as they come — one or several — or its barcode, or both.

You get back that item's category, subcategory and brand. With a taxonomy, the answer is always one of your lines — or Others when nothing fits. A barcode also returns the product name, size, photos and where it was found.

Customizable taxonomy (optional)

Through the API: your own list of Category > Subcategory lines, sent with each call. Add a rule to any line to say when it applies, or rules for every item. See API.

Without a taxonomy — and always on the Search page — it proposes ordinary retail categories.

What is a token, and how to get one

A personal access key — it is what lets you search here and call the API.

Get one free on the Token page: enter your email, type the 6-digit code we send you, and the token is saved in your browser. A new token replaces your previous one.

One item cleaned or one barcode looked up is one look-up. A free token has 20 look-ups a day and 50 a month.

What is kept, and what is never kept

To improve the service and its models, Items Cleaner may keep what you send and what it answers: the descriptions, barcodes and taxonomy lines of a request, the category, subcategory and brand returned, and the lines the web gave for a barcode.

What is never kept: your email address, your IP address, your token, or anything else that identifies you. Your email is used once, to send your code; only a keyed fingerprint and a masked form such as ol…b@tr….com remain. Your IP address is scrambled with a secret key and today’s date before anything is written, so it cannot be worked back out. Your token stays in your browser; the service holds only a fingerprint of it. A token is issued only after the one-time code sent to your email is confirmed, so nobody can get one in your name.

By requesting a token or calling the API you agree to this.

Last updated

—