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": "Find AI-powered transcription services that serve enterprise healthcare customers"
}'
{
  "metadata": {},
  "data": {
    "userPrompt": "Find AI-powered transcription services that serve enterprise healthcare customers",
    "marketName": "AI Healthcare Transcription Services",
    "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,
    "locations": [
      {
        "countryCode": "GB",
        "countryName": "United Kingdom"
      }
    ]
  }
}

​
Overview

This endpoint converts your natural language business question into structured search criteria that our AI algorithms can use to discover relevant companies.
Workflow Step: This is Step 1 of the Market Research Workflow.

​
Usage

The endpoint accepts a simple search input and returns comprehensive search criteria including:
  • Market Classification: Type, role, and geographic scope
  • Keyword Groups: Features, users, synonyms, and irrelevant terms
  • Search Parameters: Count limits, project type, and constraints

​
Best Practices

Pro Tip: Be specific in your search input. Instead of “AI companies”, try “AI-powered transcription services for enterprise healthcare customers.”
Important: The generated search criteria will be used in subsequent discovery steps. Take time to review and potentially refine the criteria before proceeding to company discovery.

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

Search criteria generated

​
metadata
object
required
​
data
object
required