Sign in
Web Presence Review

Review Company

Conduct a web presence review of a business. You must identify the business one of two ways:

  • By domain — submit domain (accepts a bare domain, full URL, or email; we extract the registered domain).
  • By name + address — submit submitted_business_name together with at least one address field (address_line_1, city, state_province, postal_code, or country).

All other fields (submitted_phone, submitted_email, submitted_full_name, submitted_description) are optional and help us identify the business and surface additional detail.

Requires a valid X-API-KEY header. Rate limited to 5 requests per second.

Testing: You can use example.org as a test domain to verify your integration without hitting real data sources or incurring any cost to you. It returns a static fixture response with realistic data.

post/api/v1/company/search

Request body

domainstring nullable

The business's domain. Required unless you provide submitted_business_name together with an address. Accepts a bare domain, full URL, or email — we reduce it to the registered domain per Mozilla's Public Suffix List. (RFC 1034/1035 for ASCII, IDNA2008 for internationalized.)

submitted_business_namestring nullable

The business's name. Required (along with an address) if you do not provide domain.

submitted_descriptionstring nullable

A description of the business's industry/operations

address_line_1string nullable

Line 1 of the business address. At least one address field is required when identifying the business by name instead of domain.

address_line_2string nullable

Line 2 of the business address.

citystring nullable

City of the business address.

state_provincestring nullable

State/Province of the business address.

postal_codestring nullable

Postal code of the business address.

countrystring nullable

Country of the business address

submitted_emailstring nullable

The email of the business or applicant. (Emails should conform to the IETF RFC 5322 spec)

submitted_phonestring nullable

The phone number of the business or applicant. (Phone numbers should conform to the ITU-T E.164 standard)

submitted_full_namestring nullable

The full name of the applicant.

match_profile_idstring uuid nullable

ID of the TrueBiz match profile to use when processing the request.

external_tracking_refstring nullable

ID used in your system to track this request.

Example request

{
  "domain": "example.net",
  "submitted_business_name": "Bob's Burritos",
  "submitted_description": "Bob's Burritos is a local institution proudly serving top quality Mexican street food to the Memphis area since 1967.",
  "address_line_1": "123 Main St.",
  "address_line_2": "Suite 100",
  "city": "Memphis",
  "state_province": "TN",
  "postal_code": "37501",
  "country": "USA",
  "submitted_email": "bob@yahoo.com",
  "submitted_phone": "+19015555555",
  "submitted_full_name": "Bob Smith",
  "external_tracking_ref": "abc_defg12345678",
  "match_profile_id": "00000000-0000-0000-0000-000000000000"
}

Response

OK

namestring nullable

The name of the company.

formation_type'Corporation' | 'General Partnership' | 'Limited' | 'Limited Liability Company' | 'Limited Partnership' | 'Limited Liability Partnership' | 'Limited Liability Limited Partnership' | 'No Liability' | 'Non-Profit' | 'Professional Corporation' | 'Professional Limited Liability Corporation' | 'Sole Proprietorship' | 'Unlimited'

An enumeration.

has_closed_indicatorsboolean nullable

true when any one supported source signals the business is closed — either permanently or temporarily. Signals include closure language on the website, a CLOSED_PERMANENTLY or CLOSED_TEMPORARILY status from Google Places, and matching Yelp/Scrap.io flags. Treat as a strong indicator the business should not be approved without manual review. null means we did not gather enough signal to make a determination — it is not the same as false.

founded_yearinteger nullable

The year the company was founded.

descriptionstring nullable

A short summary of what the company does, sourced from the company's own website content and/or third-party business data providers. May be null for parked, unreachable, or extremely sparse sites where no usable description could be derived.

social_media_profilesstring[]

All social media profile URLs we associate with the company. This is the complete set; social_media_detailed_profiles is the enriched subset of these for which we were able to collect follower counts and other per-profile metrics.

pdf_report_linkstring uri nullable

Link to download a PDF outlining the results in a visual format.

ui_portal_linkstring uri nullable

Link to see the full response in TrueBiz's web portal.

is_blockedboolean

Is this business blocked for fraud based on information that your company has provided to us.

tracking_idstring uuid nullable

ID used to track this request in TrueBiz's application.

external_tracking_refstring nullable

ID used in your system to track this request.

Example response

{
  "name": "Acme, Inc.",
  "domain": {
    "name": "acme.com",
    "registration_date": "1992-07-14",
    "last_update_date": "2021-12-15",
    "expiration_date": "2028-07-12",
    "is_resolvable": true,
    "is_registered": true,
    "is_ssl_valid": true,
    "is_webserver_responsive": true,
    "historical_archives": [
      {
        "url": "2021-12-15",
        "taken_date": "2021-12-15"
      }
    ],
    "registrar": {
      "name": "MarkMonitor, Inc.",
      "country": "United States",
      "website": "https://markmonitor.com"
    },
    "hosting_providers": [
      {
        "name": "Google",
        "country": "United States"
      }
    ],
    "has_robots_txt": true,
    "has_apex_and_www": true,
    "estimated_tech_spend": 1000,
    "estimated_tech_spend_history": [
      {
        "spend": 850,
        "detected_date": "2022-06-01"
      }
    ],
    "website_tech_activity": [
      {
        "year": 2023,
        "month": 6,
        "added": 4,
        "removed": 1,
        "total": 25
      }
    ],
    "domains_with_matching_credentials": [
      {
        "domain": "example.com",
        "technologies": [
          "google-analytics",
          "olark"
        ]
      }
    ],
    "inbound_linking_domains_count": 5,
    "inbound_redirects": [
      "example.xyz"
    ],
    "cohosted_domains": [
      "example.xyz"
    ]
  },
  "website_content": {
    "evaluated_url": "https://www.acme.com/",
    "title": "Acme Inc. | World's Best Manufacturer of Anvils",
    "description": "Having trouble with a pesky road runner?  Buy an Acme Anvil and have no problems tomorrow!",
    "privacy_policy_link": "https://acme.com/privacy",
    "terms_of_service_link": "https://acme.com/terms",
    "return_policy_link": "https://acme.com/return",
    "refund_policy_link": "https://acme.com/refund",
    "cancellation_policy_link": "https://acme.com/cancellation",
    "shipping_policy_link": "https://acme.com/shipping",
    "opengraph_image_link": "https://acme.com/image.png",
    "primary_language": "English",
    "has_subscriptions": true,
    "pages_linked_from_homepage": 15,
    "content_flags": [
      "Tobacco"
    ],
    "content_flag_details": [
      {
        "reasoning": "The page contains references to online casino games and sports betting.",
        "location": "https://www.example.com/"
      }
    ],
    "custom_content_flags": [],
    "detected_brands": [
      {
        "name": "Nike",
        "count": 10,
        "action": "warn"
      }
    ],
    "policy_analysis": {
      "sources": [
        {
          "type": "Privacy Policy",
          "url": "https://www.example.com/privacy",
          "title": "Acme Inc. Privacy Policy",
          "company_name": "Acme Inc.",
          "language": "en",
          "last_updated": "2021-01-01",
          "change_policy": "Example Co reserves the right to make changes to this Privacy Policy. Any updates will be posted on our website.",
          "policy_contact": "support@example.com",
          "synopsis": "This privacy policy outlines the types of personal information that is received and collected and how it is used. It also outlines the steps we take to protect your personal information."
        }
      ],
      "analyses": [
        {
          "question": "Does the policy detail the website's privacy policy and how the data of customers is protected, used or disclosed?",
          "answer": "Yes",
          "sources": [
            "https://www.acme.com/privacy",
            "https://www.acme.com/privacy2"
          ]
        }
      ]
    },
    "duplicate_websites": [
      {
        "url": "https://acmeanvils.com",
        "percent_matched": 96
      }
    ],
    "payment_processors": [
      "Stripe"
    ],
    "multi_level_marketing_name": "Amway"
  },
  "website_traffic": {
    "visits_per_month": 10000,
    "time_on_site": 15.55,
    "pages_per_visit": 3.75,
    "bounce_rate": 15.55,
    "paid_search_share": 0.5,
    "google_results_count": 10000,
    "top_referring_sites": [
      {
        "url": "https://referrer.co",
        "traffic_share": 0.35
      }
    ],
    "paid_search_visits": 1000,
    "top_keywords": {
      "organic": [
        "anvils",
        "cartoon anvils"
      ],
      "paid": [
        "example",
        "example2"
      ]
    },
    "anomalous_keywords": [
      "firearms",
      "gummy bears"
    ]
  },
  "primary_address": {
    "full_address": "5000 Market Street, #9616, San Francisco, CA 94103, United States",
    "line_1": "5000 Market Street",
    "line_2": "#9616",
    "city": "San Francisco",
    "state_province": "CA",
    "postal_code": "94103",
    "country": "United States",
    "postal_service_flags": [],
    "google_maps_link": "https://maps.google.com/?q=37.7756852,-122.4179707",
    "is_valid": true
  },
  "additional_addresses": [
    {
      "full_address": "5000 Market Street, #9616, San Francisco, CA 94103, United States",
      "line_1": "5000 Market Street",
      "line_2": "#9616",
      "city": "San Francisco",
      "state_province": "CA",
      "postal_code": "94103",
      "country": "United States",
      "postal_service_flags": [],
      "google_maps_link": "https://maps.google.com/?q=37.7756852,-122.4179707",
      "is_valid": true
    }
  ],
  "founded_year": 1955,
  "description": "Acme, Inc. is a large manufacturing company best known for it's quality anvils.",
  "industry": {
    "primary_industry": "Iron and Steel Forging",
    "tags": [
      "Steelworks",
      "Anvils",
      "Coyotes"
    ],
    "primary_naics": "332111",
    "additional_naics_codes": [
      "512110"
    ],
    "primary_sic": "3462",
    "additional_sic_codes": [
      "7819"
    ],
    "primary_mcc": {
      "code": "3499",
      "description": "Fabricated Metal Products, Not Elsewhere Classified"
    },
    "additional_mcc_codes": [
      {
        "code": "7812",
        "description": "Motion Picture and Video Tape Production and Distribution"
      }
    ]
  },
  "primary_phone_number": {
    "number": "+13105555555",
    "is_valid": true,
    "country_code": "US",
    "country_name": "United States",
    "links_to_company": [
      {
        "duration": "P2Y5M"
      }
    ]
  },
  "additional_phone_numbers": [
    {
      "number": "+15558675309",
      "is_valid": true,
      "line_type": "Landline",
      "country_name": "United States",
      "country_code": "US",
      "links_to_company": [
        {
          "type": "Direct",
          "duration": "P2Y10M"
        }
      ]
    }
  ],
  "email_addresses": [
    {
      "address": "partners@acme.com",
      "is_valid": true
    }
  ],
  "news_articles": [
    {
      "title": "Acme, Inc. announces it is filing for bankruptcy.",
      "link": "https://example.com/news/acme-inc-files-for-bankruptcy",
      "date": "2026-08-14T22:40:16.290Z",
      "snippet": "CEO Wiley E. Coyote announced that Acme, Inc. is filing for bankruptcy tomorrow at 9 AM.",
      "thumbnail": "https://example.com/thumn/acme-vault-empty.png",
      "concerns": [
        "Bankruptcy"
      ]
    }
  ],
  "social_media_profiles": [
    "https://facebook.com/acme",
    "https://linkedin.com/company/acme-inc",
    "https://crunchbase.com/organization/acme",
    "https://twitter.com/acme",
    "https://www.google.com/maps/place/?q=place_id:ChIJE_P9I5yAhYARkssH6GvVJ2g"
  ],
  "social_media_detailed_profiles": [
    {
      "url": "https://facebook.com/acme",
      "follower_count": 22232239,
      "like_count": 22160933,
      "last_posted_content_at": "2023-07-01T10:23:00Z"
    }
  ],
  "people": [
    {
      "name": "Wiley E. Coyote",
      "job_title": "Chief Executive Officer",
      "linkedin_url": "https://www.linkedin.com/in/wiley-e-coyote/",
      "profile_picture": "https://media.licdn.com/dms/image/D4D03AQGDnwFEps6idg/profile-displayphoto-shrink_200_200/0/1673360179524?e=1688601600&v=beta&t=bpXAkQdRR7liIMck3FQ7maRE-XeMwtChfWt73oB7YZ0",
      "state_province": "California",
      "city": "San Francisco",
      "country": "United States"
    }
  ],
  "ecommerce": {
    "platform": "shopify",
    "product_count": 100,
    "vendor_count": 20,
    "average_price": 15.55,
    "minimum_price": 9.99,
    "maximum_price": 100.99,
    "currency_code": "USD",
    "last_updated_date": "2023-03-23"
  },
  "connected_entities": [
    {
      "name": "Roadrunner Restaurants",
      "domain": "roadrunner-restaurants.com",
      "sources": [
        {
          "type": "Shared address",
          "context": "Both businesses are listed at 123 Main Street, Chicago, IL.",
          "url": "https://roadrunner-restaurants.com"
        }
      ]
    }
  ],
  "risks": {
    "validity": [],
    "notice": [],
    "risk": []
  },
  "block_details": {
    "created_at": "2023-12-25T19:30:25.000+00:00",
    "expires_at": "2030-12-29T23:59:59.000+00:00"
  },
  "tracking_id": "00000000-0000-0000-0000-000000000000",
  "external_tracking_ref": "abc_defg12345678"
}