---
title: "List matched suggestions for property unmatched handles"
method: GET
path: "/api/unmatched-handles/property"
tags: ["Social Scraping Sessions"]
---

# List matched suggestions for property unmatched handles

`GET /api/unmatched-handles/property`

## Request

- Base URL: `https://api.sponsorunited.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sponsorunited.com/api/unmatched-handles/property`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sponsorunited/apis/sponsorunited-api/docs/api/unmatched-handles/property/get.ts> (a function with typed inputs; its response is checked against the schema)

Aggregates unmatched handles across the given scraping sessions and returns fuzzy-match property suggestions.

## Query parameters

- `social_scraping_session` integer[], required
- `matching_threshold` integer, required
- `matching_max_count` integer, required
- `account_type` string

## Response `200`

Unmatched handles with property match suggestions.

- object[]
  - `unmatchedHandle` string
  - `entityName` string
  - `accountType` 'business' | 'individual' | 'creator' | 'unknown', nullable
  - `platformMetadata` object, nullable: Platform-specific classification signals. Shape varies by platform.
    - `platform` 'facebook' | 'instagram' | 'twitter'
    - `category_list` object[], nullable: Facebook only. Page categories with resolved account types.
      - `id` string
      - `name` string
      - `api_enum` string
      - `account_type` string
    - `account_type` integer, nullable: Instagram only. Raw account type (0=individual, 1=business, 2=creator).
    - `is_business` boolean, nullable: Instagram only.
    - `professional_type` string, nullable: Twitter only.
    - `business_account` boolean, nullable: Twitter only.
  - `socialMediaValues` string[]
  - `socialScrapingSessionId` integer
  - `matchingBrands` object[], nullable
    - `id` integer
    - `name` string
    - `logo` string, nullable
    - `matchingPercentage` number, float
  - `highestMatchingPercentage` number, float, nullable

## Other responses

- `401`: Unauthenticated
- `422`: Validation error (missing social_scraping_session, matching_threshold or matching_max_count).

---

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