Female Names

Autocomplete female first names by prefix. Returns the most popular female names matching the query, sorted by frequency. Uses the same prefix-list architecture as first names but from a dedicated female names dataset.

Try it

—

Endpoint

GET/v1/first-name/female/<query>

Base URL: https://autocomplete.namedone.com

SDK Usage

femaleNames()

1import { createClient } from "@namedone/autocomplete"
2
3const nd = createClient("nd_...")
4const { results } = await nd.femaleNames("jo")

curl

1# Exchange your API key for a token
2curl -X POST https://token.namedone.com/v1 \
3  -H "Content-Type: application/json" \
4  -d '{"apiKey":"nd_..."}'
5
6# Query the female names endpoint
7curl "https://autocomplete.namedone.com/v1/first-name/female/jo?token=<jwt>"

Response Format

JSON

{
  "results": [
    {
      "id": "first-name-0",
      "text": "Joanne",
      "type": "first-name"
    }
  ],
  "query": "jo"
}

API Query Parameters

Sent as query string parameters on the HTTP request to the API.

Parameter	Type	Default	Description
token	string	—	JWT obtained from the token API. Required for authentication.

SDK Options

Passed to the SDK methods (e.g. firstNames(query, opts)). These are processed client-side and never sent to the API.

Option	Type	Default	Description
limit	number	10	Maximum number of results (1–50). Applied client-side by the SDK.
simple	boolean	false	Simplify response: deduplicate by text and strip to {text, type}.

Examples

Query: jo

{
  "results": [
    {
      "id": "first-name-0",
      "text": "Joanne",
      "type": "first-name"
    },
    {
      "id": "first-name-1",
      "text": "Josephine",
      "type": "first-name"
    },
    {
      "id": "first-name-2",
      "text": "Jodie",
      "type": "first-name"
    },
    {
      "id": "first-name-3",
      "text": "Jocelyn",
      "type": "first-name"
    },
    {
      "id": "first-name-4",
      "text": "Jolene",
      "type": "first-name"
    }
  ],
  "query": "jo"
}

Query: ab

{
  "results": [
    {
      "id": "first-name-0",
      "text": "Abigail",
      "type": "first-name"
    },
    {
      "id": "first-name-1",
      "text": "Abbie",
      "type": "first-name"
    },
    {
      "id": "first-name-2",
      "text": "Abby",
      "type": "first-name"
    },
    {
      "id": "first-name-3",
      "text": "Abigail",
      "type": "first-name"
    },
    {
      "id": "first-name-4",
      "text": "Abela",
      "type": "first-name"
    }
  ],
  "query": "ab"
}

Notes

Female names are sourced from ONS baby names statistics (female) for England and Wales.
Uses a dedicated DynamoDB table and CloudFront KVS, separate from the combined first names dataset.
Results include only names recorded as female in the source data.
Source: Office for National Statistics licensed under the Open Government Licence v3.0.