Connect SDK to your workflow

Google Sheets

Paste URLs into a sheet, select rows and refresh public metrics from the SocialDataKit menu. No application to build.

1. Download the Google Sheets script. Open your own spreadsheet and choose Extensions → Apps Script.
2. Replace the default empty script with the downloaded script, save and reload your spreadsheet.
3. Choose SocialDataKit → Prepare profile sheet, then Connect SDK API key. Google will ask you to authorise your script. Use a sheet whose editors you trust.
4. Paste Instagram, TikTok or YouTube channel profile URLs in column A. Select up to 25 rows and choose Refresh selected profile rows.

Your key stays in your user properties, outside spreadsheet cells. Development keys produce clearly labelled samples. Live refreshes use up to one credit per profile; cached results up to one day old are free. The script asks before refreshing.

n8n

An importable workflow that retrieves an SDK profile and appends its metrics to Google Sheets.

1. Download the n8n workflow and import it using Import from file.
2. Import the column headers into a Google Sheets tab named SDK Profiles.
3. In Profile URL, enter your profile link. In Get SDK profile, select a Header Auth credential: name x-api-key, value your SDK API key.
4. In Append to Google Sheets, connect Google and replace the spreadsheet ID. Run manually once. You can replace the manual trigger with a Schedule Trigger after checking the result.

The workflow is inactive on import and contains no credentials. Failed API calls stop the run; missing metrics remain empty.

Make

A ready-made scenario blueprint: SDK profile → Google Sheets row.

1. Download the Make blueprint. Create a scenario and choose Import blueprint.
2. In the HTTP API Key Auth module, add a keychain placing your SDK API key in the x-api-key header. Replace the profile URL query value.
3. Connect the Google Sheets module to your account. Choose the spreadsheet and a tab named SDK Profiles with these headers.
4. Run once and inspect the new row. Enable a schedule only when you are ready to automate credit usage.

Your Google connection and SDK keychain are selected after import. Cell values use RAW mode so profile text cannot become spreadsheet formulas.

Hosted MCP

Connect an MCP client that supports Streamable HTTP and an Authorization header. SDK runs the server; no repository or local process is required.

https://api.socialdatakit.com/mcp

{
  "mcpServers": {
    "socialdatakit": {
      "url": "https://api.socialdatakit.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SDK_API_KEY"
      }
    }
  }
}

Create or revoke a key in API Keys. Start with a development key for free samples, then switch to a production key for live data. Never share a configuration containing a real key. OAuth-only clients cannot use this API-key connection.

Ask your agent to list TikTok profile endpoints, check your balance or retrieve a public profile. Endpoint discovery and balance checks are free; successful fresh data calls use the normal credits. MCP protocol requests and data calls share the workspace rate limit.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "sdk-key",
      "description": "SocialDataKit API key",
      "password": true
    }
  ],
  "servers": {
    "socialdatakit": {
      "type": "http",
      "url": "https://api.socialdatakit.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:sdk-key}"
      }
    }
  }
}

Bulk analysis and campaign reports

Bulk analysis accepts 5 / 25 / 100 / 200 profile URLs per analysis on Air / Pro / Pro Max / Ultra. Compare metrics and export CSV. Each successful fresh profile uses one existing credit.

Campaigns group tracked creators and posts, set reporting dates and save weekly reports. Pro includes 1 campaign, Pro Max 5 and Ultra 20. Campaign reporting and exports use no extra credits; daily tracking uses your existing balance and monitoring cap.

Use reports in another workflow

Read a campaign’s current report using its ID from the Campaigns screen. Set format=csv for CSV, or report_id for a saved weekly report. Requires a production key and paid campaign access.

curl 'https://api.socialdatakit.com/v1/workflows/campaign-report?id=CAMPAIGN_ID' \
  -H 'x-api-key: YOUR_SDK_API_KEY'

See the API guide for local MCP, CLI and endpoint details.