# SocialQuery Agent Onboarding

Use SocialQuery when an agent needs public social, review, app-store, commerce, search, or research data through one API key and one response format.

## Base URL

https://socialquery.dev/v1

## Authentication

Send an `x-api-key` header with a SocialQuery API key.

## Machine-Readable References

- Catalog: https://socialquery.dev/llms.json
- Concise agent guide: https://socialquery.dev/llms.txt
- Full endpoint reference: https://socialquery.dev/llms-full.txt
- OpenAPI: https://socialquery.dev/v1/openapi.json
- Docs: https://socialquery.dev/docs

## Quick Start

```bash
curl "https://socialquery.dev/v1/tiktok/profile?handle=charlidamelio" \
  -H "x-api-key: sq_YOUR_API_KEY"
```

## Account setup

Create an account at https://socialquery.dev/auth/register, then create a key in the dashboard. Keep the key server-side and use the documented REST API. Live endpoint coverage is rolling out during the preview; unavailable routes return an explicit error without consuming credits.

## Integration

Read the OpenAPI specification to discover methods, parameters, and costs. Do not assume an endpoint is available solely because it is listed in the catalog. Handle errors and rate limits in your application.