# 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

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

```json
{"openapi":"3.1.0","info":{"title":"Delpha Data Quality API","version":"1.0.0"},"tags":[{"name":"Website","description":"A company's website is often the first touchpoint for customers, partners, and search engines—making it a cornerstone of trusted business data.\nDelpha'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.\n\nOur evaluation covers four key aspects:\n- **Completeness:** Detects and fills missing website fields.\n- **Validity:** Verifies that the website is active and accessible.\n- **Consistency:** Normalizes the URL and checks if it matches the original input.\n- **Accuracy:** Confirms that the website aligns with contextual data such as company name or legal ID.\n\nThe 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.\n\nWith **Website Finder** and **Website Validator**, your CRM and analytics stay connected to the right online identities, boosting reliability and customer trust."}],"servers":[{"url":"https://api.delpha.io","description":"Production API server"}],"security":[{"oauth2":["api/access"]}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"OAuth2 client credentials flow for API access","flows":{"clientCredentials":{"tokenUrl":"https://secure.delpha.io/oauth2/token","scopes":{"api/access":"Access to the public API"}}}}},"schemas":{"WebsiteSubmitInput":{"properties":{"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website","description":"The website URL"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"The name of the entity owning the website"},"linkedin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin","description":"The LinkedIn URL of the entity"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email","description":"The email address of the entity"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"The country of the entity"}},"type":"object","title":"WebsiteSubmitInput","description":"Payload to submit a new website quality job."},"WebsiteSubmitOutput":{"properties":{"job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Id","description":"The job ID. Required if status <= 300."},"message":{"type":"string","title":"Message","description":"The message to return"},"status":{"type":"string","enum":["SUCCESS","ERROR"],"title":"Status","description":"The status of the process"},"status_code":{"type":"integer","title":"Status Code","description":"The status code to return"}},"type":"object","required":["message","status","status_code"],"title":"WebsiteSubmitOutput","description":"Response after submitting a new website quality job."}}},"paths":{"/v1/website":{"post":{"tags":["Website"],"summary":"Submit website for finding and validation","description":"Submit an website for finding and validation. Returns a job ID for tracking the process.","operationId":"findAndValidateWebsite","requestBody":{"description":"\n\n**Validation Rules:**\n\n- **Validation mode:** `website` must be provided\n- **Recommendation mode:** At least one of `name`, `linkedin`, or `email` must be provided\n- If all fields are provided, both validation and recommendation will be performed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteSubmitInput"}}},"required":true},"responses":{"202":{"description":"Job submitted to assess_website_v16","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteSubmitOutput"}}}},"400":{"description":"Invalid website format or missing required fields","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteSubmitOutput"}}}},"401":{"description":"Authentication failed - invalid or missing OAuth 2.0 token","content":{"application/json":{"schema":{"properties":{"message":{"type":"string"}},"type":"object"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteSubmitOutput"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteSubmitOutput"}}}},"502":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteSubmitOutput"}}}}}}}}}
```

## Get website finder and validator job status

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

```json
{"openapi":"3.1.0","info":{"title":"Delpha Data Quality API","version":"1.0.0"},"tags":[{"name":"Website","description":"A company's website is often the first touchpoint for customers, partners, and search engines—making it a cornerstone of trusted business data.\nDelpha'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.\n\nOur evaluation covers four key aspects:\n- **Completeness:** Detects and fills missing website fields.\n- **Validity:** Verifies that the website is active and accessible.\n- **Consistency:** Normalizes the URL and checks if it matches the original input.\n- **Accuracy:** Confirms that the website aligns with contextual data such as company name or legal ID.\n\nThe 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.\n\nWith **Website Finder** and **Website Validator**, your CRM and analytics stay connected to the right online identities, boosting reliability and customer trust."}],"servers":[{"url":"https://api.delpha.io","description":"Production API server"}],"security":[{"oauth2":["api/access"]}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"OAuth2 client credentials flow for API access","flows":{"clientCredentials":{"tokenUrl":"https://secure.delpha.io/oauth2/token","scopes":{"api/access":"Access to the public API"}}}}},"schemas":{"WebsitePullOutput":{"properties":{"message":{"type":"string","title":"Message","description":"A human-readable message describing the current state or outcome of the job."},"status":{"type":"string","enum":["SUCCESS","ERROR"],"title":"Status","description":"The status of the process"},"status_code":{"type":"integer","title":"Status Code","description":"The HTTP status code representing the job's current state."},"result":{"anyOf":[{"$ref":"#/components/schemas/WebsiteModel"},{"type":"null"}],"description":"The result of the website quality job"},"process_time":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Process Time","description":"The total time taken to process the job, in seconds."}},"type":"object","required":["message","status","status_code"],"title":"WebsitePullOutput","description":"Response after retrieving the status and result of an website quality job."},"WebsiteModel":{"properties":{"data_type":{"$ref":"#/components/schemas/DataType","description":"The type of data for this field"},"normalized_value":{"type":"string","title":"Normalized Value","description":"Normalized website value."},"label":{"type":"string","enum":["No","OK","Unknown"],"title":"Label","description":"Label for the website."},"scores":{"$ref":"#/components/schemas/ScoresModel","description":"Scores for the field"},"recommendations":{"items":{"$ref":"#/components/schemas/WebsiteRecommendation"},"type":"array","title":"Recommendations","description":"Recommendations for the website."}},"type":"object","required":["data_type","normalized_value","label","scores","recommendations"],"title":"WebsiteModel","description":"Model representing the details of an website field."},"DataType":{"type":"string","enum":["email","social_network","name","legal_id","phone","address","website"],"title":"DataType"},"ScoresModel":{"properties":{"accuracy":{"type":"number","maximum":1,"minimum":-1,"title":"Accuracy","description":"Accuracy score","default":-1},"validity":{"type":"integer","maximum":1,"minimum":-1,"title":"Validity","description":"Validity score","default":-1},"completeness":{"type":"number","maximum":1,"minimum":0,"title":"Completeness","description":"Completeness score","default":0},"consistency":{"type":"integer","maximum":1,"minimum":0,"title":"Consistency","description":"Consistency score","default":0}},"type":"object","title":"ScoresModel","description":"Model representing the scores for an email field."},"WebsiteRecommendation":{"properties":{"url":{"type":"string","title":"Url","description":"Recommended website value."},"score":{"type":"number","maximum":1,"minimum":0,"title":"Score","description":"Confidence score for the recommendation."}},"type":"object","required":["url","score"],"title":"WebsiteRecommendation","description":"Model representing a recommendation for an website."}}},"paths":{"/v1/website/{job_id}":{"get":{"tags":["Website"],"summary":"Get website finder and validator job status","description":"Retrieve the result and status of a previously submitted website finder and validator job.","operationId":"getWebsiteResult","responses":{"200":{"description":"Job succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsitePullOutput"}}}},"202":{"description":"Job is still running.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsitePullOutput"}}}},"400":{"description":"Input validation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsitePullOutput"}}}},"401":{"description":"Authentication failed - invalid or missing OAuth 2.0 token","content":{"application/json":{"schema":{"properties":{"message":{"type":"string"}},"type":"object"}}}},"500":{"description":"Failed to retrieve job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsitePullOutput"}}}},"504":{"description":"Job timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsitePullOutput"}}}}}}}}}
```