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

# Search for Information on a Username

`GET /usernames`

## 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.net/spokeo/apis/untitled-api.md) · [All operations](https://skmtc.net/spokeo/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spokeo/untitled-api/versions/632a13baca1c/schema)