Skip to content

Licence and how to credit

What you may do with the data on this site, in plain words. Data you generate is free and needs no credit. The datasets we publish as files are free too, and ask for a credit when you share them.

Which rule applies to what

WhatLicenceCredit
Data you generate with the tools, the bulk export or the APIFree for any lawful useNot required. Welcome.
Datasets published as files: the sample customer data, and the CSV and JSON files attached to the data guidesCreative Commons Attribution 4.0 (CC BY 4.0)Required when you publish or pass on the data
Guides, charts and page text© Fakenamely. Quote freely.A link back with the quote. Ask before republishing a whole guide.
Code: the fakenamely API client and the postal-code-formats packageMITKeep the licence notice with the code

The acceptable-use rules in the terms apply to every row: lawful use only.

How to give credit

Put the credit where a reader would look for it: next to the data, in a README, in a dataset description or in a reference list. Name Fakenamely, link to the page the data came from, and name the licence. Pick the wording that fits and copy it.

README, tutorial or blog post

One line near the data, or in a credits section.

Sample data: Fakenamely (https://fakenamely.com), CC BY 4.0.

Dataset description (Kaggle, Hugging Face, a data repository)

In the description or the licence field of the copy you publish.

Source: Fakenamely, "Sample Customer Data", version 1 (https://fakenamely.com/datasets/sample-customer-data). Licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). All records are fictional.

Course handout or slide

A footnote on the slide or page that uses the data.

Data: Fakenamely sample customer data, https://fakenamely.com/datasets/sample-customer-data (CC BY 4.0). Fictional records.

Paper or report

In the reference list.

Ruan, V. (2026). Sample Customer Data, version 1 [Data set]. Fakenamely. https://fakenamely.com/datasets/sample-customer-data

BibTeX

For LaTeX users.

@misc{fakenamely_customers_v1,
  author       = {Ruan, Vincent},
  title        = {Sample Customer Data, version 1},
  year         = {2026},
  howpublished = {\url{https://fakenamely.com/datasets/sample-customer-data}},
  note         = {Fictional records. CC BY 4.0}
}

What the licence does not cover

A licence says what you may copy. It does not make a use lawful. The terms of use forbid fraud, impersonation and forged documents, whatever the licence.

Some of the reference data behind the generators belongs to others. US ZIP codes come from the GeoNames postal dataset, which is itself CC BY 4.0, and the street names from the US Census Bureau. The data and methodology page lists every source and its licence. If you republish a dataset from this site, our credit line covers our part; theirs is listed there.

Every record is fictional. A name or a street can match a real one by chance, as any made-up name can. The data describes nobody.

Where to get the data

The sample customer data comes as CSV and JSON in 100, 1,000 and 20,000 rows. For other columns or sizes, use the bulk test data generator or the free API. Questions about a use this page does not cover go to the contact page.

Frequently asked questions

Do I have to credit Fakenamely for a name or address I generated?

No. Anything you generate with the tools, the bulk export or the API is free to use for any lawful purpose, with no credit. That has been in the terms of use from the start. A credit is welcome, and the wording on this page works for it.

When is a credit required?

When you publish or pass on one of the datasets this site publishes as a file. Those are under CC BY 4.0. Private use needs nothing: a test fixture that never leaves your team does not have to show a credit to anyone.

Can I use the data in a commercial product or a paid course?

Yes. Neither the generated data nor the CC BY 4.0 datasets restrict commercial use. The acceptable-use rules still apply: no fraud, no impersonation, no forged documents.

Can I change a dataset and share my version?

Yes. CC BY 4.0 allows changes. Say that you changed it, keep the credit, and do not suggest that Fakenamely endorses your version.

May I use the data to teach a class?

Yes, and you do not need to ask. The sample files were sized for it: 100 rows to read by eye, 1,000 for a first query, 20,000 for an exercise that needs a real table. A footnote credit on the handout is enough.

Updated