Skip to main content

Kaaj Web Presence Status API

This document describes the API endpoint for checking the status of the web presence report given the task_id.

Endpoint​

GET https://api.kaaj.ai/application/web-presence/status/{app_id}

Headers​

Authorization: Bearer <your_api_key> Content-Type: multipart/form-data

Request Parameters​

Field NameTypeDescription
task_idstringTask id recieved from the web presence api
app_idstringApp id given while submitting the web presence api

Example Request​

https://api.kaaj.ai/application/web-presence/status/AOFtest1?task_id=987da4ba-ecaa-4abd-8231-416ae3fd4395

Success Response

  • Code: 200 OK
  • Content: JSON object with the following fields:
Field NameTypeDescription
reportobjectContains research field with an array of objects having id, title, content and citations properties
app_idstringApplication ID associated with the report
analysisobjectContains business_basics (industry, customer base, scope), credit_analysis (risk factors, web presence strength), review_analysis (ratings, complaints), directory_presence (listings, memberships), and social_media_analysis (platform presence, activity)
industry_infoobjectContains industry classification codes and their descriptions (e.g., MCC, NAICS, SIC)

Success Response​

Code: 200 OK

{
  "status": "complete",
  "data": {
    "app_id": "AOFtest1",
    "report": {
      "research": [
        {
          "id": "res001",
          "title": "Basic Business Information",
          "content": "Valley Meats is a local meat market operating since 1966...",
          "citations": ["https://example.com/business-directory/valley-meats"]
        }
      ]
    },
    "analysis": {
      "business_basics": {
        "industry": "Meat Markets",
        "naics_code": "445210",
        "customer_base": ["B2C"],
        "business_scope": "local",
        "locations_count": 1,
        "business_website": "N/A",
        "service_diversification": {
          "value": "moderate",
          "metrics": "high = 5+ distinct service/product lines; moderate = 3-4 distinct lines; low = 1-2 service/product lines",
          "reasoning": "The business offers a variety of meats (beef, chicken, pork, elk, venison, buffalo), fresh and smoked sausages, snack sticks, hot dogs, brats, as well as convenience store items like liquor, beer, wine, salads, hot sandwiches, and Indian food. This constitutes 3-4 distinct product/service lines: fresh meats, smoked/processed meats, convenience store items, and prepared foods."
        }
      },
      "credit_analysis": {
        "key_risk_factors": [
          "No official business website",
          "No active social media presence",
          "Customer complaints about product quality and customer service"
        ],
        "web_presence_strength": {
          "value": "low",
          "metrics": "high = active on 3+ platforms, has offical website, professional presentation; moderate = active on 1-2 platforms with occasional updates, has offical website; low = minimal online presence or outdated information",
          "reasoning": "The business lacks an official website and has no active social media presence. Its online presence is limited to business directories and review sites."
        },
        "key_positive_indicators": [
          "High review volume with generally positive ratings",
          "Consistent business information across directories",
          "Long operating history (since 1966)"
        ],
        "business_legitimacy_confidence": {
          "value": "moderate",
          "metrics": "high = verified business listings, consistent information across sources, professional web presence, good social media presence, good reviews; moderate = some inconsistencies but generally legitimate appearance, average social media presence, average reviews; low = significant inconsistencies, red flags, or minimal verifiable information",
          "reasoning": "The business is listed in major directories with consistent information and has a long operating history, but the lack of an official website and social media presence lowers confidence."
        }
      },
      "review_analysis": {
        "review_volume": {
          "value": "high",
          "metrics": "high = 100+ reviews for small business, 500+ for medium business; moderate = 30-99 for small, 100-499 for medium; low = fewer than 30 for small, fewer than 100 for medium business",
          "reasoning": "The business has 176 reviews on Chamber of Commerce and 12 on Yelp, totaling over 180 reviews, which is high for a small local business."
        },
        "overall_rating": 4.2,
        "complaint_patterns": [
          "Inconsistent hours",
          "Occasional product quality issues (especially with meat processing)",
          "Customer service concerns (unwelcoming staff, lack of communication)"
        ],
        "customer_service_quality": {
          "value": "moderate",
          "metrics": "high = multiple positive mentions of responsiveness/resolution; moderate = mixed feedback with some positive mentions; low = consistent complaints about service quality/responsiveness",
          "reasoning": "While many reviews are positive about staff friendliness and product quality, there are notable complaints about customer service, communication, and some negative experiences, indicating mixed feedback."
        }
      },
      "directory_presence": {
        "memberships": "none mentioned",
        "certifications": "none mentioned",
        "directory_presence_count": 5,
        "presence_in_business_directories": {
          "value": "moderate",
          "metrics": "high = present in 5+ business directories including major ones like D&B/BBB; moderate = present in 3-4 directories including at least one major directory; low = present in 0-2 directories or missing from major directories",
          "reasoning": "The business is listed in at least two major directories (Dun & Bradstreet and Buzzfile) and several industry-specific/local directories (Loc8NearMe, Yahoo Local, Chamber of Commerce, Michigan.org), totaling at least 4-5, but not all are major national directories."
        }
      },
      "social_media_analysis": {
        "activity_level": {
          "value": "none",
          "metrics": "high = multiple platforms with substantial followers (seems to be 1000+ total); moderate = few platforms with decent follower base (appears to be 100-999 total); low = minimal presence or very few followers across platforms (seems to be <100 total)",
          "reasoning": "There is no evidence of active social media presence on any major platforms."
        },
        "platform_presence": [],
        "engagement_metrics": []
      }
    },
    "industry_info": {
      "summary": "Valley Meats LLC is a retail meat market specializing in fresh and processed meat products. The business offers a variety of meats including beef, chicken, pork, and specialty meats like elk and buffalo, along with smoked sausages and convenience store items.",
      "mcc_code": "5422",
      "sic_code": "5421",
      "naics_code": "445210",
      "mcc_industry_label": "Meat Provisioners and Freezer Companies",
      "naics_industry_label": "Meat Markets"
    }
  }
}

Error Response​

Code: 400 Bad Request

Ensure all the params are correct and the task_id is valid.