TikTok

Each video becomes a bucket object carrying its description, likes, views, shares, and comment count.

Overview

Mixpeek calls the official TikTok Content API as the authorized account. It syncs that account’s videos, not arbitrary public ones.

Prerequisites

A TikTok Developer account with an approved app.
The user.info.basic and video.list scopes granted during authorization.
An OAuth authorization completed for the account you want to sync.

Configuration

Connection-level fields

Field	Required	Description
`credentials.client_key`	Yes	App Client Key from the TikTok Developer Portal
`credentials.client_secret`	Yes	App Client Secret, encrypted at rest
`credentials.access_token`	Yes	Access token, valid for 24 hours
`credentials.refresh_token`	Yes	Used to mint a new access token, encrypted at rest
`credentials.open_id`	Yes	The account’s `open_id` from the authorization response
`credentials.token_expires_at`	No	Access token expiry
`scopes`	No	Defaults to `["user.info.basic", "video.list"]`

Sync-level fields

Field	Required	Description
`source_path`	Yes by the API	Ignored by this provider, which uses the authorized `open_id`
`polling_interval_seconds`	No	Defaults to `300`

The sync API requires source_path, and the TikTok provider does not read it. Pass / and select the account through open_id on the connection.

Setup

Create and approve a TikTok app

Open the TikTok Developer Portal.
Create an app and request Login Kit plus Content Posting API access.
Copy the Client Key and Client Secret.
Add user.info.basic and video.list to the app’s scopes.

Authorize the account

Run the TikTok Login Kit OAuth flow. The callback returns an access token, a refresh token, and the account’s open_id.

Access tokens last 24 hours. Store the refresh token; Mixpeek uses it to renew.

Create the storage connection

from mixpeek import Mixpeek

client = Mixpeek(api_key="your-mixpeek-api-key")

connection = client.organizations.connections.create(
    name="Brand TikTok Account",
    provider_type="tiktok",
    provider_config={
        "credentials": {
            "type": "oauth",
            "client_key": "your-client-key",
            "client_secret": "your-client-secret",
            "access_token": "your-access-token",
            "refresh_token": "your-refresh-token",
            "open_id": "your-open-id",
        },
    },
)
print(f"Created connection: {connection['connection_id']}")

import { Mixpeek } from 'mixpeek-sdk'

const client = new Mixpeek({ apiKey: 'your-mixpeek-api-key' })

const connection = await client.organizations.connections.create({
  name: 'Brand TikTok Account',
  provider_type: 'tiktok',
  provider_config: {
    credentials: {
      type: 'oauth',
      client_key: 'your-client-key',
      client_secret: 'your-client-secret',
      access_token: 'your-access-token',
      refresh_token: 'your-refresh-token',
      open_id: 'your-open-id',
    },
  },
})
console.log('Created connection:', connection.connection_id)

curl -X POST https://api.mixpeek.com/v1/organizations/connections \
  -H "Authorization: Bearer YOUR_MIXPEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Brand TikTok Account",
    "provider_type": "tiktok",
    "provider_config": {
      "credentials": {
        "type": "oauth",
        "client_key": "your-client-key",
        "client_secret": "your-client-secret",
        "access_token": "your-access-token",
        "refresh_token": "your-refresh-token",
        "open_id": "your-open-id"
      }
    }
  }'

Create the sync

cURL

curl -X POST https://api.mixpeek.com/v1/buckets/bkt_your_bucket_id/syncs \
  -H "Authorization: Bearer YOUR_MIXPEEK_API_KEY" \
  -H "X-Namespace: ns_your_namespace_id" \
  -H "Content-Type: application/json" \
  -d '{
    "connection_id": "conn_your_connection_id",
    "source_path": "/",
    "polling_interval_seconds": 3600
  }'

Instagram

The same account-scoped pattern on Instagram.

Social media overview

How social connectors map to buckets.

Get started

Connect your data

Extract features

Build retrievers

Enrich & organize

Integrate & operate

Resources

Overview

Prerequisites

Configuration

Connection-level fields

Sync-level fields

Setup

Instagram

Social media overview

​Overview

​Prerequisites

​Configuration

​Connection-level fields

​Sync-level fields

​Setup

​Related

Instagram

Social media overview

Overview

Prerequisites

Configuration

Connection-level fields

Sync-level fields

Setup

Related