---
title: "List league social scraping sessions"
method: GET
path: "/api/social-scraping-sessions"
tags: ["Social Scraping Sessions"]
---

# List league social scraping sessions

`GET /api/social-scraping-sessions`

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

Paginated listing of league social scraping sessions for a season, with brand/item counts and review status. Supports grouped rows and CSV download.

## Query parameters

- `season` integer, required
- `review_status` 'pending' | 'reviewed', required
- `grouped` boolean
- `include_empty` boolean
- `download` boolean
- `league_id` integer[]
- `property_list_id` integer
- `division_id` integer[]
- `team_id` integer[]
- `user_id` integer[]
- `reviewer` integer[]
- `type` string[]
- `platform_handle` string[]
- `status_value` integer[]
- `scouting_markets` integer[]
- `order_by` 'division_name' | 'followers_count' | 'team_name' | 'user_name' | 'reviewer_name' | 'start' | 'end' | 'brands_count' | 'items_count' | 'handle'
- `order_direction` 'asc' | 'desc'
- `order` 'asc' | 'desc'
- `page` integer
- `per_page` integer
- `infinite_scroll` boolean

## Response `200`

Paginated sessions. With infinite_scroll=true the payload uses simple pagination (next_page_url/prev_page_url, no total/last_page). download=true returns a text/csv stream.

- object
  - `current_page` integer
  - `per_page` integer
  - `total` integer, nullable: Only present with length-aware pagination; omitted when infinite_scroll=true.
  - `next_page_url` string, nullable: URL of the next page; present when infinite_scroll=true.
  - `prev_page_url` string, nullable: URL of the previous page.
  - `data` object[]
    - `id` integer
    - `type` string
    - `handle` string
    - `team_id` integer
    - `user_id` integer, nullable
    - `brands_count` integer
    - `items_count` integer
    - `statuses` string, nullable: GROUP_CONCAT of distinct user_event statuses.
    - `start_date` string, nullable
    - `end_date` string, nullable
    - `scan_group` string
    - `social_scraping_session_ids` string, nullable: Only present when grouped=true: comma-separated session ids in the group.
    - `has_unmatched_handles` boolean: Only present when grouped=true: group has at least one unmatched handle for its platform.
    - `has_rejected_companies` boolean: Only present when grouped=true: group has at least one rejected company.
    - `total_followers` integer, nullable: Only present when league_id or property_list_id is provided.
    - `platform_followers` integer, nullable: Only present when league_id or property_list_id is provided.
    - `latest_reviewed_at` string, nullable: Only present when review_status=reviewed.

## Other responses

- `401`: Unauthenticated
- `422`: Validation error: missing season or review_status, unknown property_list_id, or both league_id and property_list_id sent.

---

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