# SocialScope

> SocialScope connects creators' YouTube, TikTok and Instagram accounts to your app and gives your server one GraphQL API for their profiles, posts and metrics.

Notes for agents:

- Every page is plain Markdown at the URLs below. All pages in one file: https://docs.socialscope.hardscope.incdev.dev/llms-full.txt
- The consumer GraphQL schema (SDL) is at https://docs.socialscope.hardscope.incdev.dev/schema.graphql
- Call the API only from your server. The application key is a secret and never belongs in a browser, mobile app or URL.

## Docs

- [Quickstart](https://docs.socialscope.hardscope.incdev.dev/quickstart.md): Get registered, store the key, check readiness, launch Connect, verify the return and read data in one pass.
- [Guide for coding agents](https://docs.socialscope.hardscope.incdev.dev/agent-guide.md): Rules, an implementation checklist and a verification checklist for a coding agent integrating SocialScope into an existing app.
- [Concepts](https://docs.socialscope.hardscope.incdev.dev/concepts.md): Applications, tenants, subjects, connections, capabilities, observed metrics, availability and how they relate.
- [Authentication](https://docs.socialscope.hardscope.incdev.dev/authentication.md): How your server authenticates to SocialScope with an application key, and how to store, rotate and protect it.
- [Connect a social account](https://docs.socialscope.hardscope.incdev.dev/connect.md): Start a hosted Connect attempt, hand the browser to SocialScope, verify the return, reconnect and disconnect.
- [Read profiles, posts and metrics](https://docs.socialscope.hardscope.incdev.dev/reading-data.md): List connections, page through posts, refresh a window, look up a post by URL and poll sync jobs.
- [Sign people in with Google](https://docs.socialscope.hardscope.incdev.dev/google-identity.md): 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](https://docs.socialscope.hardscope.incdev.dev/errors.md): Every consumer-visible GraphQL error code, Connect result code, job error code and availability reason, with what to do.
- [Test your integration](https://docs.socialscope.hardscope.incdev.dev/testing.md): How to test against the dev deployment, which ownership and failure cases to cover, and what a passing test does not prove.
- [API reference](https://docs.socialscope.hardscope.incdev.dev/api-reference.md): Every consumer query and mutation with arguments, return fields, limits and a server-side example.