Publish a market

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"
}

POST

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

x-api-key

string

header

required

Pass a static API key for every request, provided by your customer support.

Path Parameters

marketId

integer

required

Unique identifier for the market study.

Required range: x > 0

Query Parameters

teamId

number | null

Unique identifier for the team.

Body

application/json

pipelineChoices

object

Show child attributes

Response

Publish a market in discovery workflow response

metadata

object

required

Show child attributes

data

object

required

Show child attributes

Quick Start

Guides

API Reference

UI Components

Overview

Usage

Pipeline Steps

Monitoring Progress

Accessing Published Data

Best Practices

Authorizations

Path Parameters

Query Parameters

Body

Response

​Overview

​Usage

​Pipeline Steps

​Monitoring Progress

​Accessing Published Data

​Best Practices

Authorizations

Path Parameters

Query Parameters

Body

Response

Overview

Usage

Pipeline Steps

Monitoring Progress

Accessing Published Data

Best Practices