Proofly

Stop Fake Profiles Before They Start

AI-powered identity verification API that matches user data to real social media profiles. Protect your AI agent platform from fraudulent signups.

pnpm add @plank-proofly/api

proofly.ts

import PlankProofly from '@plank-proofly/api';

function getClient(apiKey: string, baseURL: string) {
  return new PlankProofly({ apiKey, baseURL });
}

export async function findMutualFriendsAction(
    apiKey: string, baseURL: string, params: PlankProofly.FindMutualFriendCreateParams
) {
  try {
    const client = getClient(apiKey, baseURL);
    const data = await client.findMutualFriends.create(params);
    return { success: true, data };
  } catch (error) {
    return handleError(error);
  }
}

Powerful Verification Features

Protect your platform with advanced AI that verifies user identities through social media profile matching and connection analysis.

AI-Powered Profile Matching
Advanced fuzzy matching to find the right social media profile.

Match Score98%

Photo Verification
Match user photos against social media profile pictures with AI.

Connection Analysis
Verify relationships and mutual connections between profiles.

Job-Based Architecture
Submit verification jobs and check progress asynchronously.

ID: 8x92...

Multi-Input Verification
Use name, email, DOB, location, and photos for accurate matching.

Simple API Integration
Easy-to-use REST API with comprehensive documentation.

POST/v1/verify

{

"name": "John Doe",

"platform": "facebook"

}

> 200 OK

Simple, Usage-Based Pricing

Pay only for the API calls you make. Choose a plan that scales with your agent volume.

1 API call = 1 request to any endpoint.
A typical full verification uses about 4 API calls.

Starter

FreeFree

Perfect for startups and small businesses.

Get Started today:

100 API calls / month

Access to all verification endpoints

Basic profile & email matching

Photo similarity checks

Email support

API documentation access

Enterprise

CustomCustom

/month

Tailored solutions for large platforms and risk teams.

Everything in Professional +

Custom API call bundles (starting at 5,000+ calls / month)

Custom verification pipelines

Dedicated support team / Slack channel

SLA guarantees

On-prem / VPC deployment options

Comprehensive Documentation

Everything you need to integrate our SDK. Detailed guides, code examples, and reference documentation.

Install SDK

pnpm add @plank-proofly/api

methods.txt

Key SDK methods

checkFacebookFriend.createverify friendship status for a profile URL

findMutualFriends.creatediscover mutual friends across user IDs

profiles.searchsearch by name, location, or keywords

verifyProfilePhoto.createvalidate whether a photo matches a user

jobs.retrievepoll async job results for any endpoint

proofly.ts

import PlankProofly from '@plank-proofly/api';

const client = new PlankProofly({
  apiKey: process.env['PLANK_PROOFLY_API_KEY'],
  baseURL: process.env['PLANK_PROOFLY_API_URL'], // optional override
});

async function main() {
  const { jobId } = await client.checkFacebookFriend.create({
    profileUrl: 'https://facebook.com/profile',
  });

  const job = await client.jobs.retrieve({ jobId });
  console.log(job);
}

main().catch(console.error);

Want to see a full working app? Check out our open-source demo that wires up authentication, forms, and live responses using the SDK.

Frequently Asked Questions

Everything you need to know about Pointer and how it can transform your development workflow

How does the profile verification API work?

Our API uses advanced AI and fuzzy matching algorithms to match user data (name, email, DOB, location, photos) against Facebook profiles. You submit verification jobs through our REST API, receive a job ID, and can check progress asynchronously. The system returns either an exact match or a list of possible matching profiles.

What data do I need to provide for verification?

At minimum, you need a name. Optional inputs include email, date of birth (full or year only), location (hometown or current), photos, and known associates. More data points improve matching accuracy. Our AI handles fuzzy matching to account for variations in how people list their information.

Can you verify connections between profiles?

Yes! Our service can take two or multiple social media profiles and identify mutual friends. You can also check if a profile exists in a database of connections from other known accounts, helping you verify relationships and detect fraudulent networks.

How is pricing calculated?

Pricing is usage-based at a fixed cost per API call. Each verification request counts as one API call. You can monitor your usage through the dashboard and upgrade or downgrade your plan anytime based on your needs. Enterprise customers can get custom pricing for high volumes.

Is the service compliant with privacy regulations?

Absolutely. We only access publicly available information and operate within the bounds of data protection regulations. Our scraping service uses ethical methods and we never store personal data longer than necessary for verification. Enterprise customers can opt for on-premise deployment for maximum data control.

How do I integrate this into my AI agent platform?

Integration is simple. Sign up to get your API key, then use our REST API endpoints to submit verification jobs. We provide comprehensive documentation powered by Scalar, with code examples in multiple languages. The job-based architecture means verification happens asynchronously, so it won't block your user signup flow.

What counts as an API call?

Any request to our public endpoints (/profiles/search, /check-facebook-friends, /find-mutual-friends, /verify-profile-photo) counts as 1 API call.

How many API calls does a full verification use?

It depends on your workflow, but a typical flow (search → friends → mutual friends → photo check) uses about 4 API calls.

Can I call individual endpoints separately?

Yes. You’re free to design your own pipeline. We just count total calls across all endpoints.

Stop fake profiles today

Join AI agent platforms already using our verification API to ensure authentic user profiles and protect their communities