Skip to main content
The Web Presence check helps verify a business’s legitimacy by analyzing its online presence, including official websites, social media profiles, and digital footprint. This guide explains how to run the check, what data to provide, and how to interpret the results.

​
Overview

The check analyzes various aspects of a business’s web presence:
  • Official website verification
  • Domain registration and history
  • Social media presence
  • Business directory listings
  • Online activity patterns

​
Running the Check

​
API Endpoint

POST https://api.parcha.ai/api/v1/startKYBAgentJob

​
Request Parameters

Important: You must use your own agent key, not a default or public agent key. Your agent key can be found in the Parcha dashboard under your agent’s settings, or in the “Test API Integration” dialog.
​
agent_key
string
required
Your KYB agent key from the Parcha dashboard. This is unique to your organization and agent configuration.
​
check_id
string
required
Use "kyb.web_presence_check" for web presence verification.
​
payload
object
required
The business information for verification.

​
Example Request

curl -X POST 'https://api.parcha.ai/api/v1/startKYBAgentJob' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
  "agent_key": "your-kyb-agent-key",
  "check_id": "kyb.web_presence_check",
  "payload": {
    "id": "web-presence-check-001",
    "self_attested_data": {
      "business_name": "Parcha Labs Inc",
      "website": "https://parcha.ai",
      "business_description": "Business verification and compliance platform",
      "address": {
        "country_code": "US",
        "state": "CA",
        "city": "San Francisco"
      },
      "contact_email_address": "[email protected]",
      "contact_phone_number": "+1 (555) 123-4567"
    }
  }
}'

​
Initial Response

{
  "id": "job-abc123",
  "status": "PENDING",
  "created_at": "2024-02-15T10:30:00Z",
  "updated_at": "2024-02-15T10:30:00Z",
  "agent_id": "your-agent-key",
  "input_payload": {
    // Original request payload
  }
}

​
Retrieving Check Results

Once the job is complete, retrieve the results using the job ID with the getJobByID endpoint. Make sure to include the include_check_results=true parameter to get the full check results. 
GET https://api.parcha.ai/api/v1/getJobByID?job_id=job-abc123&include_check_results=true

​
Check Process

The web presence check follows these steps:
  1. Website Verification
    • Validates domain ownership and registration
    • Analyzes website content and structure
    • Verifies business information consistency
  2. Digital Footprint Analysis
    • Evaluates presence on business directories
    • Assesses social media profiles
    • Reviews online engagement and activity
  3. Risk Assessment
    • Checks for domain registration issues
    • Identifies website content concerns
    • Evaluates information consistency
    • Assesses online presence legitimacy

​
Check Results

Once the check is complete, you can retrieve the results using the check ID. The results will include:

​
Response Structure

{
  type: "WebPresenceCheckResult";
  passed: boolean;
  official_website_match: OfficialWebsiteMatch | null;
  other_webpages_matches: Array<OfficialWebsiteMatch> | null;
}

type OfficialWebsiteMatch = {
  url: string;
  title: string;
  visual_summary: string;
  screenshot_url?: string;
  domain_registration?: {
    registration_date: string;
    expiration_date: string;
    registrar: string;
  };
  content_analysis?: {
    last_updated: string;
    business_info_present: boolean;
    contact_info_present: boolean;
  };
}