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": [
      {
        "country": "GB",
        "address": null,
        "coordinates": null
      }
    ]
  }
}
'
{
  "metadata": {
    "marketId": 12345
  },
  "data": [
    {
      "jobId": 67890,
      "workflowId": 1,
      "workflowName": "second_pass",
      "startTime": "2024-01-15T10:30:00Z"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.forestreet.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

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

Path Parameters

​
marketId
number | null

Unique identifier for the market study.

Query Parameters

​
teamId
number | null

Unique identifier for the team to use for this discovery.

​
collectionId
number | null

Unique identifier for the collection that the market belongs to.

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