---
title: "Get metadata for social scraping session filters"
method: GET
path: "/api/social-scraping-sessions/metadata"
tags: ["Social Scraping Sessions"]
---

# Get metadata for social scraping session filters

`GET /api/social-scraping-sessions/metadata`

## 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/social-scraping-sessions/metadata`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sponsorunited/apis/sponsorunited-api/docs/api/social-scraping-sessions/metadata/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns filter metadata (divisions, teams, users, reviewers, platform handles) for the given season and review status. Exactly one of league_id, team_id, or property_list_id must be provided.

## Query parameters

- `season` integer, required
- `review_status` string, required
- `league_id` integer
- `team_id` integer
- `property_list_id` integer
- `include_empty` boolean
- `scouting_markets` integer[]

## Response `200`

Metadata for the given filters. For league_id or property_list_id: includes divisions, teams, users, reviewers, and platformHandles. For team_id: includes users, reviewers, and platformHandles.

- object
  - `divisions` object[]
  - `teams` object[]
  - `users` object[]
  - `reviewers` object[]
  - `platformHandles` object[]

## Other responses

- `422`: Validation failure. Returned when none or more than one of league_id, team_id, and property_list_id are provided, or when season/review_status are missing.

---

[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)