POST
/
markets
/
discover
curl --request POST \
  --url https://api.forestreet.com/markets/discover \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "type": "<string>",
  "marketName": "<string>",
  "searchTerms": [
    {}
  ],
  "domains": [
    {}
  ],
  "country": "<string>"
}'
{
  "marketId": 2
}

​
Body Request Object Example

{
    "type": "keyword",
    "marketName": "Transcription Services",
    "searchTerms": ["AI Transcription"],
    "domains": ["ai-media.tv", "rev.com"],
    "country": "all"
}

​
Body

type
string
default: "keyword"

This is the type of search you would like to run. Default is keyword, more options coming soon.

marketName
string
default: ""

This is the name of the market you would like to search for.

searchTerms
array
default: "[]"

This is an array of search terms to use for the search. If no search terms are provided, we automatically generate a list of search terms related to the market name.

domains
array
default: "[]"

This is an array of domains to use for the search. If no domains are provided, we automatically generate a list of domains related to the market name.

country
string
default: "all"

This is the country you would like to search in.

​
Response

marketId
number

A unique identifier for the market, used to retrieve the progress and results.

Momentum ScoreStatus