Face2Social API
API for face-based social profile search. Face2Social lets you upload a photo and find matching social media profiles across supported networks.
Base URL
https://dashboard.face2social.com/api/v1
Authentication
The API uses Bearer Token (JWT). Sign in via /auth/signin and send the token in Authorization: Bearer <token> on each request. Public endpoints (e.g. /optout, /landing/email) have security: [] and require no token.
Authentication
- HTTP: Bearer Auth
- API Key: cookieAuth
- API Key: appClient
- HTTP: Bearer Auth
JWT token in Authorization header. Format: Authorization: Bearer <token>
Security Scheme Type: | http |
|---|---|
HTTP Authorization Scheme: | bearer |
Bearer format: | JWT |
Canonical server session cookie in every environment (api.session.cookie_name). Guest search also requires appClient and an active, unowned session; this cookie alone grants no account access.
Security Scheme Type: | apiKey |
|---|---|
Cookie parameter name: | face2social_session |
Spoofable app-flow selector, not device attestation or entitlement. Only the bounded ios_app value/form, or web_guest when the server's web guest flag is on, selects the guest flow; server-side feature and session ownership checks remain mandatory. With App Attest on, ios_app guest starts also need an attested session (POST /auth/app-attest).
Security Scheme Type: | apiKey |
|---|---|
Header parameter name: | X-F2S-Client |
Short-lived opaque partner-cabinet session bearer token, obtained from POST /partner/cabinet/session. Distinct from bearerAuth (the admin JWT) — a cabinet token does not grant admin access.
Security Scheme Type: | http |
|---|---|
HTTP Authorization Scheme: | bearer |
Contact