---
title: "Update a league's social scraping settings."
method: PUT
path: "/api/league/{league_id}/social-scraping-settings"
tags: ["League"]
---

# Update a league's social scraping settings.

`PUT /api/league/{league_id}/social-scraping-settings`

## 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/league/{league_id}/social-scraping-settings`
- Auth: HTTP bearer

Creates or updates the per-platform (Twitter, Facebook, Instagram, TikTok) social scraping settings for the league. Only the platforms present in the request body are modified.

## Path parameters

- `league_id` integer, required

## Request body

- LeagueUpdateSocialScrapingSettingsRequest
  - `twitter` LeagueSocialScrapingPlatformSettings
    - `enabled` boolean: Whether scraping is enabled for the platform.
    - `frequency_value` integer: How often to scrape, paired with frequency_unit.
    - `frequency_unit` string: Unit for the scraping frequency.
    - `week_day` string: Day of week scraping runs on.
    - `end_day_offset` integer: Offset, in days, applied to the scraping window end.
  - `facebook` LeagueSocialScrapingPlatformSettings
    - `enabled` boolean: Whether scraping is enabled for the platform.
    - `frequency_value` integer: How often to scrape, paired with frequency_unit.
    - `frequency_unit` string: Unit for the scraping frequency.
    - `week_day` string: Day of week scraping runs on.
    - `end_day_offset` integer: Offset, in days, applied to the scraping window end.
  - `instagram` LeagueSocialScrapingPlatformSettings
    - `enabled` boolean: Whether scraping is enabled for the platform.
    - `frequency_value` integer: How often to scrape, paired with frequency_unit.
    - `frequency_unit` string: Unit for the scraping frequency.
    - `week_day` string: Day of week scraping runs on.
    - `end_day_offset` integer: Offset, in days, applied to the scraping window end.
  - `tiktok` LeagueSocialScrapingPlatformSettings
    - `enabled` boolean: Whether scraping is enabled for the platform.
    - `frequency_value` integer: How often to scrape, paired with frequency_unit.
    - `frequency_unit` string: Unit for the scraping frequency.
    - `week_day` string: Day of week scraping runs on.
    - `end_day_offset` integer: Offset, in days, applied to the scraping window end.

## Response `200`

The league with its updated per-platform social scraping settings.

## Other responses

- `403`: The user lacks the social scraping settings permission.
- `404`: League not found.

---

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