V2 Businesses Website Changes Enrich
curl --request POST \
--url https://api.explorium.ai/v2/businesses/website_changes/enrich \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"business_ids": [
"8adce3ca1cef0c986b22310e369a0793"
]
}
'import requests
url = "https://api.explorium.ai/v2/businesses/website_changes/enrich"
payload = { "business_ids": ["8adce3ca1cef0c986b22310e369a0793"] }
headers = {
"api_key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({business_ids: ['8adce3ca1cef0c986b22310e369a0793']})
};
fetch('https://api.explorium.ai/v2/businesses/website_changes/enrich', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.explorium.ai/v2/businesses/website_changes/enrich",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'business_ids' => [
'8adce3ca1cef0c986b22310e369a0793'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"api_key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.explorium.ai/v2/businesses/website_changes/enrich"
payload := strings.NewReader("{\n \"business_ids\": [\n \"8adce3ca1cef0c986b22310e369a0793\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api_key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.explorium.ai/v2/businesses/website_changes/enrich")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"business_ids\": [\n \"8adce3ca1cef0c986b22310e369a0793\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.explorium.ai/v2/businesses/website_changes/enrich")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"business_ids\": [\n \"8adce3ca1cef0c986b22310e369a0793\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"response_context": {
"correlation_id": "<string>",
"request_status": "success",
"time_taken_in_seconds": 123
},
"data": [
{
"business_id": "<string>",
"data": {
"url": "<string>",
"change_description": "<string>",
"change_implication": "<string>",
"date": "2023-11-07T05:31:56Z"
}
}
],
"total_results": 123
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Sync
Website changes
POST
/
v2
/
businesses
/
website_changes
/
enrich
V2 Businesses Website Changes Enrich
curl --request POST \
--url https://api.explorium.ai/v2/businesses/website_changes/enrich \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"business_ids": [
"8adce3ca1cef0c986b22310e369a0793"
]
}
'import requests
url = "https://api.explorium.ai/v2/businesses/website_changes/enrich"
payload = { "business_ids": ["8adce3ca1cef0c986b22310e369a0793"] }
headers = {
"api_key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({business_ids: ['8adce3ca1cef0c986b22310e369a0793']})
};
fetch('https://api.explorium.ai/v2/businesses/website_changes/enrich', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.explorium.ai/v2/businesses/website_changes/enrich",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'business_ids' => [
'8adce3ca1cef0c986b22310e369a0793'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"api_key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.explorium.ai/v2/businesses/website_changes/enrich"
payload := strings.NewReader("{\n \"business_ids\": [\n \"8adce3ca1cef0c986b22310e369a0793\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api_key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.explorium.ai/v2/businesses/website_changes/enrich")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"business_ids\": [\n \"8adce3ca1cef0c986b22310e369a0793\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.explorium.ai/v2/businesses/website_changes/enrich")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"business_ids\": [\n \"8adce3ca1cef0c986b22310e369a0793\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"response_context": {
"correlation_id": "<string>",
"request_status": "success",
"time_taken_in_seconds": 123
},
"data": [
{
"business_id": "<string>",
"data": {
"url": "<string>",
"change_description": "<string>",
"change_implication": "<string>",
"date": "2023-11-07T05:31:56Z"
}
}
],
"total_results": 123
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Description
The Company’s Website Content Changes Enrichment endpoint enables users to track changes in website content over time, helping businesses monitor updates, keyword appearances, and messaging shifts. This is particularly useful for competitive intelligence, compliance tracking, and brand monitoring. The data includes:- Detection of content changes in key sections of a company’s website.
- Keyword-based monitoring, allowing users to track the appearance or disappearance of specific terms.
- Timestamped records of detected modifications to ensure historical tracking.
- Logical AND search: The system evaluates predefined conditions, ensuring that all input keywords must appear together in the retrieved snippets.
v2: this endpoint accepts either a single ID (a string) or a list of up to 50 IDs — the separate
/bulk_enrich route is gone. See v2 conventions.Enrich by company details instead of IDs
business_ids is the primary way to call this endpoint. If you don’t have Explorium IDs yet, you can send businesses_to_match instead: up to 50 companies, described with the same fields the Match businesses endpoint accepts (name, domain, url, linkedin_url). Each company is matched and enriched in the same call. Send either business_ids or businesses_to_match, never both (that returns a 422). Any parameters the endpoint takes work the same either way.
{
"businesses_to_match": [
{ "name": "Explorium", "domain": "explorium.ai" },
{ "name": "Unknown Co", "domain": "unknown-co.example" }
]
}
{
"response_context": {
"correlation_id": "ebe38f2b99ad423e84f93d2be5e75b20",
"request_status": "success",
"time_taken_in_seconds": 5.38
},
"data": [
{
"input": { "name": "Explorium", "domain": "explorium.ai", "url": null, "linkedin_url": null },
"business_id": "340c8040bd50cbab9c7df718bbe51cc9",
"data": { "business_id": "340c8040bd50cbab9c7df718bbe51cc9", "...": "same fields as an ID-based request" },
"warnings": []
},
{
"input": { "name": "Unknown Co", "domain": "unknown-co.example", "url": null, "linkedin_url": null },
"business_id": null,
"data": null,
"warnings": []
}
],
"total_results": 1,
"total_matches": 1
}
input and returns the matched business_id. Companies that don’t match come back with business_id: null and data: null, and aren’t charged. total_matches counts the matched rows.
How It Works
How It Works
- Input: Provide a
business_idobtained from the Match Businesses API, along with optionalkeywordsseparated by commas. The system will return only results where all keywords appear together. - Processing: The system scans the target website and detects changes in text and keyword occurrences.
- Output: A structured response highlighting updated content, extracted snippets, and relevant URLs.
Best Practices
Best Practices
- Monitor competitors’ websites to track strategic updates and product announcements.
- Analyze keyword trends to detect shifts in branding and messaging.
- Leverage historical data to identify long-term content evolution and strategic priorities.
- Ensure regulatory compliance by tracking content modifications in sensitive sectors.
- Use comma-separated keywords to refine searches, ensuring that all specified terms appear together.
Website Changes Output Signal
Website Changes Output Signal
| SignalAPI | Name | Description | Data Type |
|---|---|---|---|
| url | Website page of detected change | URL from which the changes were derived | url |
| change_description | Type of content change | Text describing the content modification on the website as compared to the previous version. | string |
| change_implication | Description of content change | Text indicating the strategic significance of the content change on the website | string |
| date | Content change timestamp | Date the content change on the website occurred. | datetime |
Body Params - Try Me Example
business_ids: 8adce3ca1cef0c986b22310e369a0793
Body
application/json
- V2BusinessEnrichRequest
- V2BusinessEnrichRequest
Provide exactly one of business_ids or businesses_to_match; at most 50 entities.
Response
Successful Response
- V2BusinessEnrichResponse[WebsiteChangesOutputSchema]
- V2BusinessMatchEnrichResponse[WebsiteChangesOutputSchema]
This is base response model for all responses in partner service.
Was this page helpful?