Social & Audience Verification

This guide shows you how to implement Instagram account and demographics verification, one of the Social & Audience Verification types available in vouch. See all verification types →

Example: Instagram Account & Demographics Verification

Instagram demographic verification is critical for creator marketplaces, influencer marketing platforms, and brand partnerships. Traditional methods rely on screenshots that are easily faked, or expensive third-party analytics tools that require API access. vouch enables your business to verify social account ownership and audience demographics directly from Instagram's own data - with cryptographic proof that can't be faked.

This example demonstrates how users can prove their Instagram account ownership and audience demographics through authenticated access to their Instagram account, with cryptographic proof that defeats deepfake followers and inflated metrics.

See It in Action

Watch how Instagram demographics verification works. Users prove their account ownership, follower metrics, and audience demographics through authenticated access to their Instagram account:

Step 1: Select Data Source

For this Social & Audience Verification example, we'll use "Instagram - Proof of Account with Stats and Demographics" as our data source. This data source allows users to verify Instagram account ownership, follower metrics, and audience demographics by proving access to their Instagram account. Instagram stores verified account and audience information that vouch can cryptographically confirm.

See all Social & Audience data sources →

Step 2: Redirect Users to vouch

To trigger the Instagram account & demographics verification process, redirect the user to vouch:

import { Vouch } from '@getvouch/sdk';

const vouch = new Vouch({
  customerId: "1be03be8-5014-413c-835a-feddf4020da2",   // Your unique customer ID
  apiKey: "your-api-key",                                // Your API key
});

const { verificationUrl, requestId } = await vouch.getDataSourceUrl({
  datasourceId: "687d6f6f-5346-4fb1-9552-222d4a225451", // Instagram - Proof of Account with Stats and Demographics data source
  inputs: { ig_handle: "zkseanzk" }, // 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", // Verification delivery endpoint (optional)
});

// Redirect the user to vouch
window.location.href = verificationUrl;

This opens vouch in a new tab where users authenticate with their Instagram account to verify account ownership and audience demographics. After verification, they're redirected back to your application with the verified data.

Step 3: Receive Verification Data

When Instagram account & demographics verification is complete, vouch sends a POST request to the webhookUrl you specified in Step 2:

{  "requestId": "...",  "outputs": {    "handle": "...",    "follower_count": "...",    "media_count": "...",    "accounts_reached": "...",    "follower_views": "...",    "nonfollower_views": "...",    "countries": "..."  },  "webProofs": [...]}

Payload structure:

• requestId: The unique ID of the verification request
• outputs: Verified account and audience data extracted from the user's Instagram account
• webProofs: Array of cryptographic verifications, each containing:
  • outputs: Data extracted from this specific verification
  • presentationJson: The cryptographic proof object used for verification
  • decodedTranscript: Human-readable HTTP request/response data

Note: The webProofs array will be absent when the data source contains sensitive data. Only the extracted outputs are retained in that case.

Webhook handling: Verify the request using your webhook secret and validate and process all outputs. Optionally, you can verify the cryptographic presentation for auditability or third-party verification. Learn how to verify web proofs →

Step 4: Test the Flow

Test the complete Instagram account & demographics verification flow using the interactive demo below. This demonstrates the exact experience your users will have:

Available Data Sources

Next Steps

Check out the Getting Started guide to learn how to integrate vouch into your application.