Publish a market
curl --request POST \
--url http://localhost:4000/v2/discovery/{marketId}/publish \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"pipelineChoices": {
"skipDiscoveryReview": false,
"runReverseGeocoding": true,
"runDunsMapper": true,
"runPeople": true,
"runNews": true,
"runEsg": true,
"runMomentumScore": true,
"runMarketRadar": false,
"runTopicAnalysis": true,
"runPhraseExplorer": true,
"runGenerateFeatureMap": true,
"sendPublishEmail": true
}
}
'import requests
url = "http://localhost:4000/v2/discovery/{marketId}/publish"
payload = { "pipelineChoices": {
"skipDiscoveryReview": False,
"runReverseGeocoding": True,
"runDunsMapper": True,
"runPeople": True,
"runNews": True,
"runEsg": True,
"runMomentumScore": True,
"runMarketRadar": False,
"runTopicAnalysis": True,
"runPhraseExplorer": True,
"runGenerateFeatureMap": True,
"sendPublishEmail": True
} }
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
pipelineChoices: {
skipDiscoveryReview: false,
runReverseGeocoding: true,
runDunsMapper: true,
runPeople: true,
runNews: true,
runEsg: true,
runMomentumScore: true,
runMarketRadar: false,
runTopicAnalysis: true,
runPhraseExplorer: true,
runGenerateFeatureMap: true,
sendPublishEmail: true
}
})
};
fetch('http://localhost:4000/v2/discovery/{marketId}/publish', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "4000",
CURLOPT_URL => "http://localhost:4000/v2/discovery/{marketId}/publish",
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([
'pipelineChoices' => [
'skipDiscoveryReview' => false,
'runReverseGeocoding' => true,
'runDunsMapper' => true,
'runPeople' => true,
'runNews' => true,
'runEsg' => true,
'runMomentumScore' => true,
'runMarketRadar' => false,
'runTopicAnalysis' => true,
'runPhraseExplorer' => true,
'runGenerateFeatureMap' => true,
'sendPublishEmail' => true
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-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 := "http://localhost:4000/v2/discovery/{marketId}/publish"
payload := strings.NewReader("{\n \"pipelineChoices\": {\n \"skipDiscoveryReview\": false,\n \"runReverseGeocoding\": true,\n \"runDunsMapper\": true,\n \"runPeople\": true,\n \"runNews\": true,\n \"runEsg\": true,\n \"runMomentumScore\": true,\n \"runMarketRadar\": false,\n \"runTopicAnalysis\": true,\n \"runPhraseExplorer\": true,\n \"runGenerateFeatureMap\": true,\n \"sendPublishEmail\": true\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-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("http://localhost:4000/v2/discovery/{marketId}/publish")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"pipelineChoices\": {\n \"skipDiscoveryReview\": false,\n \"runReverseGeocoding\": true,\n \"runDunsMapper\": true,\n \"runPeople\": true,\n \"runNews\": true,\n \"runEsg\": true,\n \"runMomentumScore\": true,\n \"runMarketRadar\": false,\n \"runTopicAnalysis\": true,\n \"runPhraseExplorer\": true,\n \"runGenerateFeatureMap\": true,\n \"sendPublishEmail\": true\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:4000/v2/discovery/{marketId}/publish")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"pipelineChoices\": {\n \"skipDiscoveryReview\": false,\n \"runReverseGeocoding\": true,\n \"runDunsMapper\": true,\n \"runPeople\": true,\n \"runNews\": true,\n \"runEsg\": true,\n \"runMomentumScore\": true,\n \"runMarketRadar\": false,\n \"runTopicAnalysis\": true,\n \"runPhraseExplorer\": true,\n \"runGenerateFeatureMap\": true,\n \"sendPublishEmail\": true\n }\n}"
response = http.request(request)
puts response.read_body{
"metadata": {
"marketId": 12345
},
"data": {
"jobIds": [
"publish-platform::publish-study::2026-01-07T11:26:50.406Z::04cda5",
"publish-platform::python-scrape::2026-01-07T11:26:50.406Z::b12a9f",
"publish-platform::python-web-traffic::2026-01-07T11:26:50.406Z::c07be2"
]
}
}{
"success": false,
"errorCode": "INVALID_INPUT",
"message": "Bad Request"
}{
"success": false,
"errorCode": "FORBIDDEN",
"message": "Forbidden"
}{
"success": false,
"errorCode": "NOT_FOUND",
"message": "Not Found"
}{
"success": false,
"errorCode": "INTERNAL_SERVER_ERROR",
"message": "Internal Server Error"
}Company Review
Publish a market
Publish discovered companies and trigger comprehensive market analysis and enrichment.
POST
/
v2
/
discovery
/
{marketId}
/
publish
Publish a market
curl --request POST \
--url http://localhost:4000/v2/discovery/{marketId}/publish \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"pipelineChoices": {
"skipDiscoveryReview": false,
"runReverseGeocoding": true,
"runDunsMapper": true,
"runPeople": true,
"runNews": true,
"runEsg": true,
"runMomentumScore": true,
"runMarketRadar": false,
"runTopicAnalysis": true,
"runPhraseExplorer": true,
"runGenerateFeatureMap": true,
"sendPublishEmail": true
}
}
'import requests
url = "http://localhost:4000/v2/discovery/{marketId}/publish"
payload = { "pipelineChoices": {
"skipDiscoveryReview": False,
"runReverseGeocoding": True,
"runDunsMapper": True,
"runPeople": True,
"runNews": True,
"runEsg": True,
"runMomentumScore": True,
"runMarketRadar": False,
"runTopicAnalysis": True,
"runPhraseExplorer": True,
"runGenerateFeatureMap": True,
"sendPublishEmail": True
} }
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
pipelineChoices: {
skipDiscoveryReview: false,
runReverseGeocoding: true,
runDunsMapper: true,
runPeople: true,
runNews: true,
runEsg: true,
runMomentumScore: true,
runMarketRadar: false,
runTopicAnalysis: true,
runPhraseExplorer: true,
runGenerateFeatureMap: true,
sendPublishEmail: true
}
})
};
fetch('http://localhost:4000/v2/discovery/{marketId}/publish', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "4000",
CURLOPT_URL => "http://localhost:4000/v2/discovery/{marketId}/publish",
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([
'pipelineChoices' => [
'skipDiscoveryReview' => false,
'runReverseGeocoding' => true,
'runDunsMapper' => true,
'runPeople' => true,
'runNews' => true,
'runEsg' => true,
'runMomentumScore' => true,
'runMarketRadar' => false,
'runTopicAnalysis' => true,
'runPhraseExplorer' => true,
'runGenerateFeatureMap' => true,
'sendPublishEmail' => true
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-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 := "http://localhost:4000/v2/discovery/{marketId}/publish"
payload := strings.NewReader("{\n \"pipelineChoices\": {\n \"skipDiscoveryReview\": false,\n \"runReverseGeocoding\": true,\n \"runDunsMapper\": true,\n \"runPeople\": true,\n \"runNews\": true,\n \"runEsg\": true,\n \"runMomentumScore\": true,\n \"runMarketRadar\": false,\n \"runTopicAnalysis\": true,\n \"runPhraseExplorer\": true,\n \"runGenerateFeatureMap\": true,\n \"sendPublishEmail\": true\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-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("http://localhost:4000/v2/discovery/{marketId}/publish")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"pipelineChoices\": {\n \"skipDiscoveryReview\": false,\n \"runReverseGeocoding\": true,\n \"runDunsMapper\": true,\n \"runPeople\": true,\n \"runNews\": true,\n \"runEsg\": true,\n \"runMomentumScore\": true,\n \"runMarketRadar\": false,\n \"runTopicAnalysis\": true,\n \"runPhraseExplorer\": true,\n \"runGenerateFeatureMap\": true,\n \"sendPublishEmail\": true\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:4000/v2/discovery/{marketId}/publish")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"pipelineChoices\": {\n \"skipDiscoveryReview\": false,\n \"runReverseGeocoding\": true,\n \"runDunsMapper\": true,\n \"runPeople\": true,\n \"runNews\": true,\n \"runEsg\": true,\n \"runMomentumScore\": true,\n \"runMarketRadar\": false,\n \"runTopicAnalysis\": true,\n \"runPhraseExplorer\": true,\n \"runGenerateFeatureMap\": true,\n \"sendPublishEmail\": true\n }\n}"
response = http.request(request)
puts response.read_body{
"metadata": {
"marketId": 12345
},
"data": {
"jobIds": [
"publish-platform::publish-study::2026-01-07T11:26:50.406Z::04cda5",
"publish-platform::python-scrape::2026-01-07T11:26:50.406Z::b12a9f",
"publish-platform::python-web-traffic::2026-01-07T11:26:50.406Z::c07be2"
]
}
}{
"success": false,
"errorCode": "INVALID_INPUT",
"message": "Bad Request"
}{
"success": false,
"errorCode": "FORBIDDEN",
"message": "Forbidden"
}{
"success": false,
"errorCode": "NOT_FOUND",
"message": "Not Found"
}{
"success": false,
"errorCode": "INTERNAL_SERVER_ERROR",
"message": "Internal Server Error"
}Overview
This endpoint publishes your discovered companies and triggers comprehensive analysis including financial data, ESG metrics, news analysis, and competitive insights.Workflow Step: This is Step 4 of the Discovery
Workflow.
Important: This is an asynchronous process that can take 45-60 minutes to complete. Use the status endpoint to monitor
progress
Usage
The endpoint accepts pipeline configuration options to control which analysis steps are performed:- Pipeline Choices: Configure which analysis steps to run
- Response: Job IDs for monitoring the publishing process
Pipeline Configuration: Choose analysis steps based on your research goals. Each step adds valuable insights but
increases processing time.
Pipeline Steps
The publishing process includes several analysis steps:- Reverse Geocoding: Convert company addresses to geographic coordinates
- DUNS Mapper: Map companies to DUNS numbers for enhanced data
- People: Extract and analyse key personnel information
- News: Gather and analyse recent news and media coverage
- ESG: Collect Environmental, Social, and Governance data
- Momentum Score: Calculate market momentum and sentiment scores
- Market Radar: Generate competitive landscape analysis
- Topic Analysis: Identify key themes and topics in the market
- Phrase Explorer: Analyse market terminology and language patterns
- Feature Map: Generate visual feature maps for market insights
- Publish Email: Send notification emails upon completion
Monitoring Progress
After starting the publishing process, you can monitor progress using the same status endpoint:GET /v2/markets/{marketId}/services/publish/status
Accessing Published Data
Once publishing is complete, you can access your market data through various endpoints: # Get companies in the market
GET /v2/markets/12345/companies
# Get ESG data
GET /v2/markets/12345/esg
Best Practices
For Better Results: - Ensure discovery is fully completed before publishing - Choose pipeline steps relevant to
your research goals - Consider the review step for quality control
Important Notes: - Only one publishing process can run per market at a time - The process cannot be interrupted
once started
Authorizations
apiKeyAuthbearerAuthsessionIdQuery