Sign in

v1

latestOpenAPI 3.1.02026-07-241695611.0 MB
Web Presence

Post Web Presence Request

Submit a web presence request.

post/web_presence_requests

Headers

Preferstring nullable

Request execution preference (RFC 7240). Use respond-async for asynchronous execution, wait=N to specify a synchronous timeout hint in seconds, or priority=low to route the task to the low-priority queue.

Example:respond-async

Request execution preference (RFC 7240). Use respond-async for asynchronous execution, wait=N to specify a synchronous timeout hint in seconds, or priority=low to route the task to the low-priority queue.

Request body

optionsV1WebPresenceRequestOptions[]

The options for the web presence request. Defaults to Order.NaicsPrediction and Order.WebsiteAnalysis if not provided.

namestring required

The name of the business to search for.

addressstring required

The address of the business.

iso2_country_code'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'XK' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW'

Enumeration of ISO 3166-1 alpha-2 country codes.

Attributes: (Various country codes like Andorra = "AD", etc.)

alternative_namesstring[] nullable

Alternative names for the business (e.g., DBA names)

officer_namesstring[] nullable

List of business officers' names.

websitestring nullable

The website URL associated with the business.

phone_numberstring nullable

A phone number associated with the business.

emailstring nullable

An email address associated with the business.

reference_idstring nullable

An optional reference ID to associate with the web presence request.

Example request

{
  "options": [
    "Order.NaicsPrediction",
    "Order.WebsiteAnalysis",
    "Order.SocialMedia",
    "Order.ReviewSummary",
    "Order.ReviewFull"
  ],
  "reference_id": "WebPresence1234",
  "social_profiles": [
    {
      "site": "linked_in:company",
      "value": "acme-corp"
    }
  ]
}

Response

Response

OR

Example response

{
  "request_type": "UNITED_STATES",
  "id": "9cdfd01c-c86c-499b-a61c-a47681fb89af",
  "created_at": "2026-07-16T19:24:27.774223",
  "updated_at": "2026-07-16T19:24:27.774237",
  "options": [
    "Order.NaicsPrediction",
    "Order.WebsiteAnalysis"
  ],
  "name": "Ray's Pizza",
  "address": "123 Main St, Anytown, USA",
  "website": "https://www.actual-valid-company-website.com/",
  "officer_names": [
    "John Doe",
    "Jane Smith"
  ],
  "phone_number": "123-456-7890",
  "email": "support@example.com",
  "reference_id": "WebPresence1234",
  "business_address_match_sources": [
    "FOUND_WEBSITE",
    "REVIEW"
  ],
  "phone_number_match_sources": [
    "FOUND_WEBSITE",
    "SOCIAL_PROFILE"
  ],
  "email_match_sources": [
    "FOUND_WEBSITE",
    "SOCIAL_PROFILE"
  ],
  "people_match": true,
  "people_match_sources": [
    "FOUND_WEBSITE",
    "DIRECTORY"
  ],
  "business_website_match": true,
  "business_website_redirect_match": true,
  "found_website": "https://example.com/",
  "website_accuracy": 0.95,
  "found_social_profiles": [
    {
      "site": "instagram",
      "username": "certifiedpowerinc",
      "metadata": {
        "is_business_account": true,
        "has_business_address": true,
        "bio": "Professional roofing services since 2010 🏠",
        "followers_count": 1250,
        "phone_number": "+12125551234",
        "email": "contact@business.com",
        "address": "123 Main St, Anytown, USA",
        "business_website": "https://www.business.com"
      },
      "found_on": [
        "FOUND_WEBSITE"
      ],
      "url": "https://www.instagram.com/certifiedpowerinc"
    }
  ],
  "input_social_profiles": [
    {
      "site": "instagram",
      "username": "certifiedpowerinc",
      "metadata": {
        "is_business_account": true,
        "has_business_address": true,
        "bio": "Professional roofing services since 2010 🏠",
        "followers_count": 1250,
        "phone_number": "+12125551234",
        "email": "contact@business.com",
        "address": "123 Main St, Anytown, USA",
        "business_website": "https://www.business.com"
      },
      "found_on": [
        "FOUND_WEBSITE"
      ],
      "url": "https://www.instagram.com/certifiedpowerinc"
    }
  ],
  "social_profiles_match": [
    {
      "site": "instagram",
      "value": "acme-corp"
    }
  ],
  "found_reviews": [
    {
      "url": "https://www.yelp.com/biz/certified-power-inc-mundelein",
      "rating": 4.5,
      "volume": 23,
      "summary": "5 reviews mention that the service was great and the owner was very helpful.",
      "phone_number": "+12125551234",
      "address": "123 Main St, Anytown, USA",
      "business_website": "https://www.example.com",
      "reviews": [
        {
          "username": "John Doe",
          "text": "This is a great review!",
          "date": "2024-01-01",
          "rating": 5
        }
      ],
      "metadata": {
        "open_state": "Open",
        "types": [
          "Restaurant",
          "Italian restaurant"
        ]
      }
    }
  ],
  "found_directory_listings": [
    {
      "source": "bbb.org",
      "url": "https://www.bbb.org/us/ca/modesto/profile/plumber/joes-plumbing-1234",
      "category": "Plumbing Contractor",
      "business_name": "Joe's Plumbing & Heating"
    }
  ],
  "website_analysis": {
    "url": "http://www.warner.com/",
    "redirects": {
      "is_redirect_url": true,
      "redirects_to": "baselayer.com"
    },
    "parked": true,
    "email_deliverable": true,
    "phone_numbers": [
      "362-345-4551",
      "(872) 628-1402"
    ],
    "emails": [
      "bennettamber@example.org",
      "goldenshawn@example.com"
    ],
    "social_profiles": [
      {
        "site": "twitter",
        "url": "https://twitter.com/michelle98",
        "username": "michelle98"
      }
    ],
    "addresses": [
      {
        "street": "913 Hendrix Gardens Suite 492",
        "city": "Jasonfurt",
        "zip": "19773",
        "latitude": 38.03012,
        "longitude": 78.47665
      }
    ],
    "people": [
      {
        "name": "Jane Smith",
        "titles": [
          "Co-Founder",
          "CEO"
        ]
      },
      {
        "name": "John Doe",
        "titles": [
          "CTO"
        ]
      }
    ],
    "website_summary": "Howard Concrete Pumping Co., Inc. is a concrete pumping contractor serving the construction industry. The company specializes in concrete placement services for residential and commercial construction projects. They operate throughout the greater metropolitan area and have been providing reliable concrete pumping solutions for over 20 years.",
    "console_url": "https://console.baselayer.com/business/dde7c16a-1f7b-11ef-9425-1edb1b067314/website_analysis",
    "screenshot_url": "https://api.baselayer.com/business/dde7c16a-1f7b-11ef-9425-1edb1b067314/website_analysis/screenshot",
    "whois_record": {
      "domain_created_at": "2020-05-15T10:30:00Z",
      "domain_age_months": 15,
      "domain_updated_at": "2023-06-01T14:45:00Z",
      "domain_expires_at": "2025-05-15T10:30:00Z",
      "registrar": "Example Registrar Inc."
    },
    "ssl_validity": {
      "issuer": "DigiCert Global Root CA",
      "subject": "www.example.com",
      "days_until_expiry": 365,
      "cert_age_days": 180,
      "key_size": 2048
    },
    "website_structure_metrics": {
      "depth": "0",
      "breadth": "5"
    }
  },
  "input_website_analysis": {
    "url": "http://www.warner.com/",
    "redirects": {
      "is_redirect_url": true,
      "redirects_to": "baselayer.com"
    },
    "parked": true,
    "email_deliverable": true,
    "phone_numbers": [
      "362-345-4551",
      "(872) 628-1402"
    ],
    "emails": [
      "bennettamber@example.org",
      "goldenshawn@example.com"
    ],
    "social_profiles": [
      {
        "site": "twitter",
        "url": "https://twitter.com/michelle98",
        "username": "michelle98"
      }
    ],
    "addresses": [
      {
        "street": "913 Hendrix Gardens Suite 492",
        "city": "Jasonfurt",
        "zip": "19773",
        "latitude": 38.03012,
        "longitude": 78.47665
      }
    ],
    "people": [
      {
        "name": "Jane Smith",
        "titles": [
          "Co-Founder",
          "CEO"
        ]
      },
      {
        "name": "John Doe",
        "titles": [
          "CTO"
        ]
      }
    ],
    "website_summary": "Howard Concrete Pumping Co., Inc. is a concrete pumping contractor serving the construction industry. The company specializes in concrete placement services for residential and commercial construction projects. They operate throughout the greater metropolitan area and have been providing reliable concrete pumping solutions for over 20 years.",
    "console_url": "https://console.baselayer.com/business/dde7c16a-1f7b-11ef-9425-1edb1b067314/website_analysis",
    "screenshot_url": "https://api.baselayer.com/business/dde7c16a-1f7b-11ef-9425-1edb1b067314/website_analysis/screenshot",
    "whois_record": {
      "domain_created_at": "2020-05-15T10:30:00Z",
      "domain_age_months": 15,
      "domain_updated_at": "2023-06-01T14:45:00Z",
      "domain_expires_at": "2025-05-15T10:30:00Z",
      "registrar": "Example Registrar Inc."
    },
    "ssl_validity": {
      "issuer": "DigiCert Global Root CA",
      "subject": "www.example.com",
      "days_until_expiry": 365,
      "cert_age_days": 180,
      "key_size": 2048
    },
    "website_structure_metrics": {
      "depth": "0",
      "breadth": "5"
    }
  },
  "industry_prediction": {
    "code": "336111",
    "title": "Automobile Manufacturing",
    "accuracy": 1,
    "keywords": [
      "Automobiles",
      "Manufacturing",
      "Cars",
      "Trucks"
    ],
    "reasoning": "Based on homepage content mentioning automobile manufacturing and assembly processes."
  },
  "scores": [
    {
      "score": 95,
      "rating": "A"
    }
  ]
}