> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.idenfy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Social Screening

> Screen companies across social media, web sources, and address audits using the iDenfy KYB social screening and audit API endpoints.

## Address, Website Audit Reports and Social Profile of Companies

<Note>
  **Requirements**

  * API key pair
  * Credits **for each** desired service
</Note>

***

### Address Audit

<Info>
  **Authorization:** `API key pair`
  **Method:** `POST`
  **Endpoint:** `https://ivs.idenfy.com/api/v2/audits/address-audit/`
</Info>

**Request structure**

| Parameter | Type   | Required | Explanation       |
| --------- | ------ | -------- | ----------------- |
| `address` | String | Yes      | Address for audit |

**Samples**

<Tabs>
  <Tab title="Request example">
    ```json theme={"system"}
    {
      "address": "string"
    }
    ```
  </Tab>

  <Tab title="Response example">
    ```json theme={"system"}
    {
      "id": "f84211c0-5ffc-4955-8b6c-d2ac3c8dd768",
      "created": "2025-03-18T13:18:38.417600Z",
      "googleMapsUrl": "https://www.google.com/maps/search/...",
      "dataId": "0x46e7186363af0e71:0x76491c4f48ca5923",
      "type": ["Building"],
      "address": "Gri\u010diupio g. 7 Gri\u010diupio g. 7, Kaunas, 51372 Kauno m. sav., Lithuania",
      "associatedBodies": ["Gri\u010diupio g. 7-m"],
      "latitude": 54.9050526,
      "longitude": 23.963629899999997,
      "riskLevel": "VERY_LOW",
      "addressAuditImages": [
        {
          "image": "IMAGE_FILE_RETURNED_HERE",
          "type": "STREET_VIEW"
        }
      ]
    }
    ```
  </Tab>
</Tabs>

***

### Website Audit

<Info>
  **Authorization:** `API key pair`
  **Method:** `POST`
  **Endpoint:** `https://ivs.idenfy.com/api/v2/audits/website-audit/`
</Info>

**Request structure**

| Parameter | Type   | Required | Explanation                      |
| --------- | ------ | -------- | -------------------------------- |
| `url`     | String | Yes      | Valid URL address of the website |

**Samples**

<Tabs>
  <Tab title="Request example">
    ```json theme={"system"}
    {
      "url": "https://idenfy.com/"
    }
    ```
  </Tab>

  <Tab title="Response example">
    ```json theme={"system"}
    {
      "id": "723ef8ad-c1ec-4d80-8632-5550ce67d3d1",
      "created": "2025-03-18T13:21:52.690606Z",
      "url": "https://idenfy.com/",
      "riskLevel": "VERY_LOW",
      "trustScore": 100,
      "blacklistScore": 0,
      "internalAuditScore": 100,
      "popularityScore": 100,
      "domainCreatedAt": "2017-09-08T12:19:34Z",
      "image": null,
      "websiteTitle": "Identity Verification Service | ID Verification - iDenfy",
      "websiteDescription": "Identity verification service for user onboarding. Mitigate fraud with instant ID verification. Meet Know Your Customer, AML regulations."
    }
    ```
  </Tab>
</Tabs>

***

### Company Social Audit

<Info>
  **Authorization:** `API key pair`
  **Method:** `POST`
  **Endpoint:** `https://ivs.idenfy.com/api/v2/audits/company-name-audit/`
</Info>

**Request structure**

| Parameter     | Type   | Required | Explanation                         |
| ------------- | ------ | -------- | ----------------------------------- |
| `address`     | String | Yes      | Registration address of the company |
| `companyName` | String | Yes      | Name of the company                 |

**Samples**

<Tabs>
  <Tab title="Request example">
    ```json theme={"system"}
    {
      "address": "string",
      "companyName": "string"
    }
    ```
  </Tab>

  <Tab title="Response example">
    ```json theme={"system"}
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "descriptionByCompany": "string",
      "address": "string",
      "phoneNumber": "string",
      "industry": "string",
      "rating": 0,
      "socialMediaProfiles": {
        "property1": null,
        "property2": null
      },
      "companyName": "string",
      "reviews": [{}]
    }
    ```
  </Tab>
</Tabs>