V2 Businesses Company Website Keywords Enrich
curl --request POST \
--url https://api.explorium.ai/v2/businesses/company_website_keywords/enrich \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"business_ids": [
"8adce3ca1cef0c986b22310e369a0793"
],
"parameters": {
"keywords": [
"cloud migration",
"data platform"
]
}
}
'import requests
url = "https://api.explorium.ai/v2/businesses/company_website_keywords/enrich"
payload = {
"business_ids": ["8adce3ca1cef0c986b22310e369a0793"],
"parameters": { "keywords": ["cloud migration", "data platform"] }
}
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'],
parameters: {keywords: ['cloud migration', 'data platform']}
})
};
fetch('https://api.explorium.ai/v2/businesses/company_website_keywords/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/company_website_keywords/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'
],
'parameters' => [
'keywords' => [
'cloud migration',
'data platform'
]
]
]),
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/company_website_keywords/enrich"
payload := strings.NewReader("{\n \"business_ids\": [\n \"8adce3ca1cef0c986b22310e369a0793\"\n ],\n \"parameters\": {\n \"keywords\": [\n \"cloud migration\",\n \"data platform\"\n ]\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/company_website_keywords/enrich")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"business_ids\": [\n \"8adce3ca1cef0c986b22310e369a0793\"\n ],\n \"parameters\": {\n \"keywords\": [\n \"cloud migration\",\n \"data platform\"\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.explorium.ai/v2/businesses/company_website_keywords/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 \"parameters\": {\n \"keywords\": [\n \"cloud migration\",\n \"data platform\"\n ]\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>",
"keywords_indicator": "<string>",
"text_results": [
{}
]
}
}
],
"total_results": 123
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Sync
Company website keywords
POST
/
v2
/
businesses
/
company_website_keywords
/
enrich
V2 Businesses Company Website Keywords Enrich
curl --request POST \
--url https://api.explorium.ai/v2/businesses/company_website_keywords/enrich \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"business_ids": [
"8adce3ca1cef0c986b22310e369a0793"
],
"parameters": {
"keywords": [
"cloud migration",
"data platform"
]
}
}
'import requests
url = "https://api.explorium.ai/v2/businesses/company_website_keywords/enrich"
payload = {
"business_ids": ["8adce3ca1cef0c986b22310e369a0793"],
"parameters": { "keywords": ["cloud migration", "data platform"] }
}
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'],
parameters: {keywords: ['cloud migration', 'data platform']}
})
};
fetch('https://api.explorium.ai/v2/businesses/company_website_keywords/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/company_website_keywords/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'
],
'parameters' => [
'keywords' => [
'cloud migration',
'data platform'
]
]
]),
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/company_website_keywords/enrich"
payload := strings.NewReader("{\n \"business_ids\": [\n \"8adce3ca1cef0c986b22310e369a0793\"\n ],\n \"parameters\": {\n \"keywords\": [\n \"cloud migration\",\n \"data platform\"\n ]\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/company_website_keywords/enrich")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"business_ids\": [\n \"8adce3ca1cef0c986b22310e369a0793\"\n ],\n \"parameters\": {\n \"keywords\": [\n \"cloud migration\",\n \"data platform\"\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.explorium.ai/v2/businesses/company_website_keywords/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 \"parameters\": {\n \"keywords\": [\n \"cloud migration\",\n \"data platform\"\n ]\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>",
"keywords_indicator": "<string>",
"text_results": [
{}
]
}
}
],
"total_results": 123
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Description
The Keyword Search on Websites Enrichment endpoint enables users to identify keyword occurrences on a company’s website. This dataset is valuable for market researchers, competitive analysts, and SEO strategists looking to analyze content relevance and online presence. The data includes:- Keyword presence detection, confirming whether a term appears on a site.
- Snippet extraction, showcasing relevant text segments containing the keyword.
- Direct URLs to content, allowing for further review and validation.
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. - Processing: The system scans the target website and retrieves keyword matches.
- Output: A structured response highlighting keyword occurrences, extracted snippets, and URLs.
Best Practices
Best Practices
- Use keyword insights to track industry-specific terminology and brand messaging.
- Analyze keyword frequency to gauge content focus and relevance.
- Leverage snippet extractions for competitor research and content benchmarking.
- Monitor website content to ensure alignment with marketing and SEO strategies.
Keyword Search on Websites Output Signal
Keyword Search on Websites Output Signal
| SignalAPI | Name | Description | Data Type |
|---|---|---|---|
| text_results | Keyword search result | JSON-formatted list of search results, indicating the location of the queried keywords within the snippet. Each result includes a snippet of text containing the keywords, the corresponding URL, and a numeric ranking of where the keyword is positioned within the snippet. | array |
| keywords_indicator | URL has keyword | True if the URL contains the queried keywords. | string |
| url | URL | Website associated with Explorium’s entity ID queried for the input keywords. | url |
Body Params - Try Me Example
business_ids: 8adce3ca1cef0c986b22310e369a0793
keywords: iphone, data
Body
application/json
- V2BusinessCompanyWebsiteKeywordsEnrichRequest
- V2BusinessCompanyWebsiteKeywordsEnrichRequest
Provide exactly one of business_ids or businesses_to_match; at most 50 entities.
Response
Successful Response
- V2BusinessEnrichResponse[CompanyWebsiteKeywordsOutputSchema]
- V2BusinessMatchEnrichResponse[CompanyWebsiteKeywordsOutputSchema]
This is base response model for all responses in partner service.
Was this page helpful?