Social & Audience Verification
A step-by-step guide on how to verify social media accounts and audience data in your application with vouch.
Why Verify Social Media Accounts and Audience?
Social & Audience Verification enables organizations to validate account ownership, account age, activity, audience metrics, and sponsored posts. This verification is critical for several use cases:
- Creator Vetting: Verify that creators have authentic accounts with real followers and engagement
- Community Access: Ensure users meet social media requirements (e.g., minimum follower count, account age)
- Fraud Prevention: Reduce fraud by verifying social signals without relying on screenshots or manual review
- Sponsored Content: Verify that sponsored posts and partnerships are authentic
vouch enables you to verify social media accounts and audience data by allowing users to prove their social media credentials through authenticated access to their social platforms, providing cryptographic proof of their account status, followers, and engagement metrics.
See it in action
Watch the video below to see how the Social & Audience Verification flow works with X. This video demonstrates verifying that a user follows a specific X account (in this case, @zkmarek), proving account ownership and followership through authenticated access to their X account:
Step 1: Select data source
For this Social & Audience Verification example, we'll use X - Following (formerly Twitter) as our data source. This data source allows users to verify their social media account by proving access to their X account, which contains their verified follower and engagement information.
The following table shows all of the available data sources that can help with social media and audience verification:
Loading data sources...
Browse more data sources in the vouch catalog.
Step 2: Redirect users to vouch
To trigger the Social & Audience Verification process, redirect the user to vouch to begin the proof generation:
import { Vouch } from '@getvouch/sdk';
const vouch = new Vouch();
const verificationUrl = vouch.getStartUrl({
requestId: crypto.randomUUID(),
datasourceId: "12ea08f3-ae24-4bce-bf2c-6f59459b40b2", // X - Following data source
customerId: "1be03be8-5014-413c-835a-feddf4020da2", // Your unique customer ID
inputs: { twitter_username: "zkmarek" }, // inputs (optional, depending on data source), when no inputs use {}
redirectBackUrl: `https://docs.getvouch.io/examples/social_and_audience`, // Return destination
webhookUrl: `https://docs.getvouch.io/api/web-proof` // Proof delivery endpoint (optional)
});
// Redirect the user to vouch
window.location.href = verificationUrl;This code opens the vouch application in a new tab. The user will complete the Social & Audience Verification process by authenticating with their X account, and then be redirected back to your application with the verification proof.
Step 3: Understanding the webhook payload
When the Social & Audience Verification is complete, vouch sends a POST request to your webhookUrl with the following structure:
{ "requestId": "...", "outputs": { "Followee": "zkMarek", "Is following": true }, "webProofs": [...]}Payload structure
requestId: The unique ID of the verification requestoutputs: Aggregated extracted and verified results across allwebProofswebProofs: Array of Web Proofs generated for this request. See webProofs structure for more details.
Please note: The webProofs array will be absent when the data source contains sensitive data.
You can pass the presentationJson object to our server for verification. This ensures that the web proof hasn't been tampered with.
Step 4: Test the Social & Audience Verification flow
Try the button below to see the complete vouch Social & Audience Verification flow in action. This will demonstrate how users verify their social media accounts and audience data using X.
Prerequisite
To run the following example, install the vlayer extension.
Next Steps
Ready to get started? Check out our Getting Started guide to learn how to integrate vouch into your application.