Skip to main content
POST
/
v2
/
discovery
/
search-criteria
Generate search criteria
curl --request POST \
  --url https://rest.forestreet.com/v2/discovery/search-criteria \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "searchType": "keywordSearch",
  "searchInput": "<string>"
}'
{
  "marketName": "<string>",
  "userPrompt": "<string>",
  "marketType": "service",
  "marketRole": "manufacturer",
  "keywords": {
    "features": [
      "<string>"
    ],
    "user": [
      "<string>"
    ],
    "synonyms": [
      "<string>"
    ],
    "irrelevant": [
      "<string>"
    ]
  },
  "seedDomains": [
    "<string>"
  ],
  "count": 123,
  "assertions": "<any>",
  "constraints": "<any>",
  "projectKind": "first_pass",
  "performSearch": true,
  "locations": [
    "<string>"
  ]
}

Authorizations

x-api-key
string
header
required

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

Body

application/json
searchInput
string
required

Input for the search.

searchType
enum<string>
default:keywordSearch

Type of search to perform.

Available options:
keywordSearch,
domainSearch

Response

200 - application/json

Search criteria generated

marketName
string
required

Name of the market associated with the study.

userPrompt
string
required

Prompt used to generate the search criteria.

marketType
enum<string>
required

Type classification of the market, such as region or category.

Available options:
service,
product
marketRole
enum<string>
required

Try to limit the companies to ones that fit a specific role in the market. Possible values are:

  • "manufacturer" – physical product manufacturing, e.g. a car manufacturer
  • "distributor" – physical product distribution, e.g. a car dealership
  • "service provider" – contractor or provider of pre-defined services, e.g. a car repair shop
  • "consultant" – consultants or advisers not themselves participating in the market, but offer advice to those who do, e.g. a motor regulatory consultant

This is a hint to the discovery process and does not guarantee that all returned companies will fit this role. If insufficient companies are found, the search will be broadened to include other roles.

If not provided, the AI will attempt to infer the role based on the market name, and assumes "manufacturer" if the market is too broad.

💡 It is recommended to write your intended role in the market name, which the AI will be able to infer from. Supplying a marketRole incompatible with the market name might degrade the output.

Available options:
manufacturer,
distributor,
serviceProvider,
service provider,
consultant,
provider
keywords
object
required

Grouped keywords associated with the search criteria.

seedDomains
string[]
required

List of seed domains associated with the search criteria.

count
number
required

Number of results returned for the search criteria.

projectKind
enum<string>
required

Type of project associated with the search criteria.

Available options:
first_pass,
second_pass,
manually_added

Indicates whether the search criteria should be used to perform a search.

locations
string[]
required

List of country codes relevant to the study.

assertions
any

Assumptions made during the search criteria generation process.

constraints
any

Constraints applied to the search criteria generation process.