Skip to content
UpriverUpriverUpriver API Docs

Sponsor channels

v1.0.0
OpenAPI 3.1.0

Upriver API

A social insights API for ad generation platforms. It provides structured signals, like psychographics, behavioral insights, trends, and audience language, to help AI models generate relevant, higher-converting ads.

Server:https://api.upriver.ai

Production API server

Client Libraries
Shell Curl

Sponsor channels

​

List the social accounts publicly associated with a sponsor.

Path Parameters
  • sponsor_id
    Type: string · Sponsor Id
    required

    Identifier of the sponsor whose social accounts to list. Sponsor identifiers appear in the sponsor_id field of sponsorship results.

Query Parameters
  • platforms
    Type: array string[] | null · Platformsnullable

    Platforms to include (e.g. instagram, tiktok, youtube). If omitted, includes all.

  • limit
    Type: integer · Limit
    min:  
    1
    max:  
    50

    Maximum number of accounts to return per page.

  • cursor
    Type: string · Cursornullable

    Pagination cursor from a previous response's next_cursor.

Responses
  • application/json
  • application/json
Request Example for get/v1/sponsors/{sponsor_id}/channels
curl 'https://api.upriver.ai/v1/sponsors/{sponsor_id}/channels' \
  --header 'X-API-Key: YOUR_SECRET_TOKEN'

{
  "sponsor_id": "br_01hzy8k9m4qp7v2wxr3d5abcde",
  "sponsor_name": "Nike",
  "results": [
    {
      "channel_id": "123e4567-e89b-12d3-a456-426614174000",
      "platform": "instagram",
      "handle": "nike",
      "url": "https://www.instagram.com/nike",
      "display_name": "Nike",
      "follower_count": 302000000
    }
  ],
  "total_count": 3,
  "next_cursor": "string",
  "has_more": false
}

Successful Response