---
title: "Search for Information on a Username"
method: GET
path: "/usernames"
tags: ["Username Search"]
---

# Search for Information on a Username

`GET /usernames`

## Request

- Base URL: `https://api.spokeo.com/v5`
- URL: `https://api.spokeo.com/v5/usernames`
- Auth: API key in header `X-api-key`

## Query parameters

- `username` string, required

## Response `200`

OK

- Username
  - `data` object
    - `social_profiles` object[]
      - `profile_url` string: The URL of a social media profile associated with the social profile
      - `profile_photo_url` string: The URL of a social media profile photo associated with the social profile
      - `network` string: The social media network associated with the social profile
      - `username` string: The username associated with the social profile
      - `display_name` string: The display name associated with the social profile
      - `search_term` string: The matching search term. It can be either a username or email.
      - `is_primary_match` boolean: A value of "true" signifies that the social profile was matched by the search query.
      - `match_type` string: This indicates whether the match type is by email or username
  - `metadata` object
    - `total_social_profiles` number: The total count in the array of social profiles returned based on your search inputs.

## Other responses

- `412`: Precondition Failed

---

[API](https://skmtc.dev/spokeo/apis/spokeo-5-api.md) - [All operations](https://skmtc.dev/spokeo/apis/spokeo-5-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spokeo/apis/spokeo-5-api/revisions/ae5285edf19c?raw)