SocialScope docs

Connect creators' YouTube, TikTok and Instagram accounts to your app, then read their profiles, posts and metrics from your server through one GraphQL API.

• Quickstart

  Get registered, store the key, check readiness, launch Connect, verify the return and read data in one pass.

• Guide for coding agents

  Rules, an implementation checklist and a verification checklist for a coding agent integrating SocialScope into an existing app.

• Concepts

  Applications, tenants, subjects, connections, capabilities, observed metrics, availability and how they relate.

• Authentication

  How your server authenticates to SocialScope with an application key, and how to store, rotate and protect it.

• Connect a social account

  Start a hosted Connect attempt, hand the browser to SocialScope, verify the return, reconnect and disconnect.

• Read profiles, posts and metrics

  List connections, page through posts, refresh a window, look up a post by URL and poll sync jobs.

• Sign people in with Google

  Use SocialScope's hosted Google handoff to sign people up or in to your own app without running a Google OAuth client.

• Errors and result codes

  Every consumer-visible GraphQL error code, Connect result code, job error code and availability reason, with what to do.

• Test your integration

  How to test against the dev deployment, which ownership and failure cases to cover, and what a passing test does not prove.

• API reference

  Every consumer query and mutation with arguments, return fields, limits and a server-side example.