Website

A company's website is often the first touchpoint for customers, partners, and search engines—making it a cornerstone of trusted business data. Delpha's Website Finder and Website Validator help you maintain clean, verified, and up-to-date web domains by checking reachability, normalizing URLs, and uncovering the most relevant official sites.

Our evaluation covers four key aspects:

• Completeness: Detects and fills missing website fields.

• Validity: Verifies that the website is active and accessible.

• Consistency: Normalizes the URL and checks if it matches the original input.

• Accuracy: Confirms that the website aligns with contextual data such as company name or legal ID.

The API returns a normalized and resolved URL (following redirects when applicable) along with quality scores. When provided with side fields like a company name or legal ID, Delpha also delivers AI-powered website recommendations with confidence scores—helping you identify the most likely official domain.

With Website Finder and Website Validator, your CRM and analytics stay connected to the right online identities, boosting reliability and customer trust.

Submit website for finding and validation

post

Submit an website for finding and validation. Returns a job ID for tracking the process.

Required scopes

This endpoint requires the following scopes:

• : Access to the public API

Authorizations

OAuth2clientCredentialsRequired

OAuth2 client credentials flow for API access

Token URL:

Body

Payload to submit a new website quality job.

websitestring · nullableOptional

The website URL

Example: https://delpha.io/

namestring · nullableOptional

The name of the entity owning the website

Example: Delpha

linkedinstring · nullableOptional

The LinkedIn URL of the entity

Example: https://www.linkedin.com/company/delphainc/

emailstring · nullableOptional

The email address of the entity

Example: [e-mail]

countrystring · nullableOptional

The country of the entity

Example: France

Responses

202

Job submitted to assess_website_v16

application/json

Response after submitting a new website quality job.

job_idstring · nullableOptional

The job ID. Required if status <= 300.

Example: 21014abc65004d2781d2e0ef4c9fbb46

messagestringRequired

The message to return

Example: Job submitted to assess_website_v16

statusstring · enumRequired

The status of the process

Example: SUCCESSPossible values:

status_codeintegerRequired

The status code to return

Example: 202

400

Invalid website format or missing required fields

application/json

401

Authentication failed - invalid or missing OAuth 2.0 token

application/json

402

Payment Required

application/json

500

Internal server error

application/json

502

Service unavailable

application/json

post/v1/website

POST /v1/website HTTP/1.1
Host: api.delpha.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 158

{
  "website": "https://delpha.io/",
  "name": "Delpha",
  "linkedin": "https://www.linkedin.com/company/delphainc/",
  "email": "[e-mail]",
  "country": "France"
}

{
  "job_id": "21014abc65004d2781d2e0ef4c9fbb46",
  "message": "Job submitted to assess_website_v16",
  "status": "SUCCESS",
  "status_code": 202
}

Get website finder and validator job status

get

Retrieve the result and status of a previously submitted website finder and validator job.

Required scopes

This endpoint requires the following scopes:

• : Access to the public API

Authorizations

OAuth2clientCredentialsRequired

OAuth2 client credentials flow for API access

Token URL:

Path parameters

job_idstringRequired

The unique identifier of the website job

Example: {"summary":"Sample job ID","value":"21014abc65004d2781d2e0ef4c9fbb46"}

Responses

200

Job succeeded.

application/json

Response after retrieving the status and result of an website quality job.

messagestringRequired

A human-readable message describing the current state or outcome of the job.

Example: Job succeeded.

statusstring · enumRequired

The status of the process

Example: SUCCESSPossible values:

status_codeintegerRequired

The HTTP status code representing the job's current state.

Example: 200

process_timenumber · nullableOptional

The total time taken to process the job, in seconds.

Example: 0.123

202

Job is still running.

application/json

400

Input validation failed.

application/json

401

Authentication failed - invalid or missing OAuth 2.0 token

application/json

500

Failed to retrieve job.

application/json

504

Job timed out.

application/json

get/v1/website/{job_id}

GET /v1/website/{job_id} HTTP/1.1
Host: api.delpha.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "message": "Job succeeded.",
  "status": "SUCCESS",
  "status_code": 200,
  "result": {
    "data_type": "website",
    "normalized_value": "https://delpha.io/",
    "label": "OK",
    "scores": {
      "validity": 1,
      "completeness": 1,
      "accuracy": 1,
      "consistency": 1
    },
    "recommendations": [
      {
        "url": "https://delpha.io/",
        "score": 0.996,
        "metadata": {
          "url": "https://delpha.io/",
          "name": "Delpha",
          "title": "Delpha — Salesforce data quality, AI-powered",
          "summary": "Delpha is an AI-powered data quality solution for Salesforce. Detect, prevent and resolve data issues across accounts, contacts and leads.",
          "rank": 1
        },
        "source_path": [
          {
            "name": "Name"
          }
        ]
      }
    ]
  },
  "process_time": 0.123
}

Submit a batch of website items

post

Submit 1..100 website items for asynchronous batch processing as ONE job (never a per-item fan-out). Returns a job_id immediately (202); poll GET /v1/website/batch/{job_id} for status and results. Each item is validated identically to the single-route POST /v1/website payload; a payload with 0 items or more than 100 is rejected with 422.

Required scopes

This endpoint requires the following scopes:

• : Access to the public API

Authorizations

OAuth2clientCredentialsRequired

OAuth2 client credentials flow for API access

Token URL:

Body

Batch envelope for POST /v1/website/batch: {"items": [...]} (1..100 items, 422 beyond); each item is shaped exactly like the single-route POST /v1/website payload (reused here by $ref as WebsiteSubmitInput).

Responses

202

Batch submitted

application/json

Response after submitting a batch quality job.

job_idstring · nullableOptional

The job ID. Required if status <= 300.

Example: 21014abc65004d2781d2e0ef4c9fbb46

item_countinteger · nullableOptional

Number of items accepted in the batch (present on success).

Example: 100

messagestringRequired

The message to return

Example: Batch submitted

statusstring · enumRequired

The status of the process

Example: SUCCESSPossible values:

status_codeintegerRequired

The status code to return

Example: 202

401

Authentication failed - invalid or missing OAuth 2.0 token

application/json

402

Payment Required

application/json

422

Invalid batch payload or size (1..100)

application/json

500

Internal server error

application/json

502

Service unavailable

application/json

post/v1/website/batch

POST /v1/website/batch HTTP/1.1
Host: api.delpha.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 170

{
  "items": [
    {
      "website": "https://delpha.io/",
      "name": "Delpha",
      "linkedin": "https://www.linkedin.com/company/delphainc/",
      "email": "[e-mail]",
      "country": "France"
    }
  ]
}

{
  "job_id": "21014abc65004d2781d2e0ef4c9fbb46",
  "item_count": 100,
  "message": "Batch submitted",
  "status": "SUCCESS",
  "status_code": 202
}

Get website batch job status

get

Poll a batch of website items submitted via POST /v1/website/batch. 202 while running (with item_count/processed_count progress); 200 once SUCCEEDED (with counts, a presigned result_url, and result_data inlined when <=1MB); 409 if the credit reservation expired before delivery (resubmit); 500 if the job failed; 504 past the 24h ceiling (batch jobs run on Batch/Vertex timescales, hours not minutes).

Required scopes

This endpoint requires the following scopes:

• : Access to the public API

Authorizations

OAuth2clientCredentialsRequired

OAuth2 client credentials flow for API access

Token URL:

Path parameters

job_idstringRequired

The unique identifier of the website batch job.

Example: {"summary":"Sample job ID","value":"21014abc65004d2781d2e0ef4c9fbb46"}

Responses

200

97/100 items succeeded

application/json

Response for GET /v1/website/batch/{job_id}. Each result_data.items[] entry is keyed to its request item by dispatch_key ({"record_id": "<job_id>#<index>"}). On success its result is the SAME object GET /v1/website/{job_id} returns for a single item. On failure it carries an error string instead of result.

messagestringRequired

A human-readable message describing the current state or outcome of the job.

Example: 97/100 items succeeded

statusstring · enumRequired

The status of the process

Example: SUCCESSPossible values:

status_codeintegerRequired

The HTTP status code representing the job's current state.

Example: 200

result_urlstring · nullableOptional

Presigned URL (1h expiry) to download the full batch result JSON from S3.

Example: https://delpha-api-batch-dev.s3.amazonaws.com/batch-results/<job_id>.json?...

item_countinteger · nullableOptional

Total number of items in the batch (present while the job is running).

processed_countinteger · nullableOptional

Number of items processed so far (present while the job is running; may be absent early in the job's lifecycle).

process_timenumber · nullableOptional

The total time taken to process the job, in seconds.

Example: 12.3

202

Job is still running.

application/json

400

Missing job_id in path parameters

application/json

401

Authentication failed - invalid or missing OAuth 2.0 token

application/json

404

No job found for job_id: ...

application/json

409

Reservation expired; please resubmit the job.

application/json

500

Job failed.

application/json

504

Job timed out.

application/json

get/v1/website/batch/{job_id}

GET /v1/website/batch/{job_id} HTTP/1.1
Host: api.delpha.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "message": "97/100 items succeeded",
  "status": "SUCCESS",
  "status_code": 200,
  "counts": {
    "total": 100,
    "succeeded": 97,
    "failed": 3
  },
  "result_url": "https://delpha-api-batch-dev.s3.amazonaws.com/batch-results/<job_id>.json?...",
  "result_data": {
    "job_id": "21014abc65004d2781d2e0ef4c9fbb46",
    "usecase": "website",
    "counts": {
      "total": 2,
      "succeeded": 1,
      "failed": 1
    },
    "items": [
      {
        "dispatch_key": {
          "record_id": "21014abc65004d2781d2e0ef4c9fbb46#0"
        },
        "result": {
          "data_type": "website",
          "normalized_value": "https://delpha.io/",
          "label": "OK",
          "scores": {
            "validity": 1,
            "completeness": 1,
            "accuracy": 1,
            "consistency": 1
          },
          "recommendations": [
            {
              "url": "https://delpha.io/",
              "score": 0.996,
              "metadata": {
                "url": "https://delpha.io/",
                "name": "Delpha",
                "title": "Delpha — Salesforce data quality, AI-powered",
                "summary": "Delpha is an AI-powered data quality solution for Salesforce. Detect, prevent and resolve data issues across accounts, contacts and leads.",
                "rank": 1
              },
              "source_path": [
                {
                  "name": "Name"
                }
              ]
            }
          ]
        }
      },
      {
        "dispatch_key": {
          "record_id": "21014abc65004d2781d2e0ef4c9fbb46#1"
        },
        "error": "Processing failed for this item."
      }
    ]
  },
  "item_count": null,
  "processed_count": null,
  "process_time": 12.3
}