How label.csv works
label.csv sends each row of your file to a model with your questions and writes the answers into new columns. This page covers the steps, the 3 kinds of question, what happens during a run, the limits and the file you get back.
Label a file in 4 steps
| Step | What to do | Details |
|---|---|---|
| 1 | Add your rows | Choose a CSV file with the column names in row 1, paste a Google Sheet link shared as "Anyone with the link", or enter a Shopify store address. |
| 2 | Pick a use case | Start from one of the 30 use cases, or choose Blank and write your own. The runner lists any column the use case expects that your file lacks. |
| 3 | Check the questions | Each question has a column name, an answer type and the question. Pick one: options as name: meaning. Scale: levels, lowest first. Yes or no: a meaning for each. |
| 4 | Run and download | Press the Answer button. The table fills in as rows come back. When the run ends, download the CSV: your columns plus an answer column and a confidence column per question. |
The 3 kinds of question label.csv answers
Pick one
The answer is one option from a list you write. Each option has a one-line meaning.
Example
What is the ticket about?
billingorderaccountbug
Scale
The answer is one level of an ordered list. You write the levels, lowest first.
Example
How urgent is the ticket?
lownormalhighurgent
Yes or no
The answer is yes or no. You write what each one means.
Example
Does it ask for a refund?
yesno
When the model is not sure
The cell says Unsure and a person decides it. The download also includes each answer's confidence, from 0 to 1.
| Kind | Unsure below |
|---|---|
| Pick one | 70% |
| Scale | 70% |
| Yes or no | 80% |
Limits
| What | Limit |
|---|---|
| Rows per run, free | 1,000 |
| Rows per run, with a pass | 50,000 |
| CSV file size | 10 MB |
| Google Sheet size | 5 MB |
| Shopify products loaded | 500 |
| Questions per run | 8 |
| Options in a pick-one question | 2 to 10 |
| Levels in a scale question | 2 to 7 |
| Columns sent per row | 30 |
| Characters sent per cell | 2,000 |
| Characters in a question | 500 |
| Requests per minute, free (10 rows each) | 40 |
| Requests per minute, with a pass (10 rows each) | 400 |
The file you download
| Column | What it holds |
|---|---|
| Your columns | Every column from your file, unchanged |
question_name | The answer, or the word unsure. Empty when the row got no answer. |
question_name_confidence | The model's confidence in that answer, from 0 to 1 |
The file name is your file's name followed by -labeled.csv. The table on the page shows the first 200 rows; the download has all of them.
Questions and answers
Is label.csv free?
Runs of up to 1,000 rows are free, with no account. A pass runs up to 50,000 rows at a time: $9 for 30 days or $19 for 90 days. It is one payment and does not renew.
Which files can I use?
A CSV file with the column names in the first row, a Google Sheet shared as "Anyone with the link", or a Shopify store's public product list. To use an Excel file, save it as CSV first.
How does a pass work?
You pay once through Stripe: $9 for 30 days or $19 for 90 days. You get a pass key, saved in your browser, that allows runs of up to 50,000 rows until the pass ends. Paste the key on the pricing page to use it in another browser.
How do I get a refund?
Email [email protected] with your pass key.
Can I run more than 1,000 rows?
Yes, with a pass: up to 50,000 rows per run, $9 for 30 days or $19 for 90 days. Without a pass, split the file into parts of up to 1,000 rows.
How many questions can I ask?
Up to 8 per run. Each question adds an answer column and a confidence column to your file.
Can I change the questions in a use case?
Yes. Every question in the runner can be edited, removed or added to before you run it.
What does Unsure mean?
The model's confidence was below the cutoff: 70% for pick-one and scale questions, 80% for yes or no. A person should decide those cells.
How accurate are the answers?
Answers can be wrong, even with high confidence. Each use-case page shows a test run on one example row. Run a sample of your own rows and check it before you rely on the rest.
Is my data stored?
No. The rows you run go through label.csv's server to OpenRouter to be answered. label.csv does not keep them. The privacy policy lists every company involved.
Which model answers the questions?
Jev, a model made by TypeSafe, through OpenRouter. label.csv is not affiliated with TypeSafe or OpenRouter.
My Google Sheet does not load. What do I do?
In Google Sheets, click Share and set General access to "Anyone with the link". Or download the sheet as CSV and upload the file.
My Shopify store does not load. Why?
label.csv reads the store's public list at /products.json. Some stores turn it off, and sites that are not on Shopify do not have it.
Some rows say "No answer for this row". Why?
The request for those rows failed. Run the file again, or run only those rows.
Can I call label.csv from my own code?
No. The terms allow use through the site only.