Spreadsheet enrichment

Upload a CSV, pick the columns to add (gender, age, nationality, or any combination), download the enriched file. The Spreadsheet tool runs in your browser, processes batches against the API on your behalf, and counts the work against your monthly quota.

Open the Spreadsheet tool

Prepare your file

The tool accepts a single CSV file with a header row. Column order does not matter — you pick the relevant columns at configuration time.

  • Format: comma-separated values ( .csv ), UTF-8 encoded.
  • Headers: the first row must contain column names.
  • Size: up to 10 MB per file. Split larger files and run them separately.
  • Country codes (optional): a column of two-letter ISO 3166-1 alpha-2 codes to scope predictions per row.

Walkthrough

  1. 01

    Upload your file

    Drag the CSV onto the upload zone, or click to browse. The tool reads the header row and renders a preview of the first ten rows.

    The Spreadsheet tool upload zone.
    The Spreadsheet tool upload zone.
  2. 02

    Configure outputs

    Each prediction is configured under its own tab — Gender, Age, Nationality. For every tab you enable, pick the relevant input column, optional country column, and the output fields you want appended.

    Tab Input column Output
    Gender First name gender , probability , count
    Age First name age , count
    Nationality Last name country , probability , count (one row per top-N candidate)
    The configuration panel showing tabs, column pickers, and output toggles.
    The configuration panel showing tabs, column pickers, and output toggles.
  3. 03

    Add your API key

    Paste your API key into the API key field. The field auto-fills if you are signed in. Without a key, only the free per-IP allowance applies.

  4. 04

    Start processing

    Click Start processing. A progress bar shows rows processed, rows remaining, and an estimated time to completion. Leave the page open in another tab — the run continues until it finishes or you cancel.

  5. 05

    Download

    When the run finishes, a download link appears. The output is a CSV with the new prediction columns appended after the input columns.

Quota cost

Your plan has a single monthly quota shared across all three services. Every prediction in the output counts as one name. A 10,000-row file with all three outputs enabled consumes 30,000 names — 10,000 per enabled output.

The tool checks your quota before processing starts. A run that would exceed your monthly cap does not start at all. Upgrade your plan or wait for the quota window to reset, then try again.

See pricing for tier limits.