Skip to main content
POST
/
v2
/
discovery
/
{marketId}
/
start
Start discovery for existing market
curl --request POST \
  --url https://rest.forestreet.com/v2/discovery/{marketId}/start \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "searchCriteria": {
    "marketName": "AI Healthcare Transcription Services",
    "userPrompt": "Find AI-powered transcription services that serve enterprise healthcare customers",
    "marketType": "service",
    "marketRole": "serviceProvider",
    "keywords": {
      "features": [
        "AI transcription",
        "speech-to-text",
        "healthcare"
      ],
      "user": [
        "healthcare",
        "enterprise",
        "hospitals"
      ],
      "synonyms": [
        "transcription",
        "dictation",
        "voice-to-text"
      ],
      "irrelevant": [
        "manual transcription",
        "human transcription"
      ]
    },
    "seedDomains": [],
    "count": 50,
    "assertions": null,
    "constraints": null,
    "projectKind": "second_pass",
    "performSearch": true,
    "locations": [
      {
        "countryCode": "GB",
        "countryName": "United Kingdom"
      }
    ]
  }
}'
{
  "metadata": {
    "marketId": 12345
  },
  "data": [
    {
      "jobId": 67890,
      "serviceName": "second_pass",
      "startTime": "2024-01-15T10:30:00Z"
    }
  ]
}

Authorizations

x-api-key
string
header
required

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

Path Parameters

marketId
string
required

Unique identifier for the market study.

Body

application/json
searchCriteria
object
required
pipelineChoices
object

Choices for the publish pipeline.

Response

Discovery started successfully, returns the job id and status

metadata
object
required
data
object[]
required
I