Skip to main content
POST
/
v2
/
discovery
/
search-criteria
/
keywords
Generate keywords for search
curl --request POST \
  --url https://rest.forestreet.com/v2/discovery/search-criteria/keywords \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --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": [
    {
      "country": "GB",
      "address": [
        "123 Healthcare St",
        "Suite 100"
      ],
      "coordinates": [
        51.5074,
        -0.1278
      ]
    }
  ]
}
'
{
  "metadata": {},
  "data": [
    "medical transcription software",
    "healthcare AI transcription",
    "enterprise clinical documentation",
    "HIPAA compliant transcription services",
    "medical voice recognition software",
    "automated clinical notes",
    "healthcare speech-to-text solutions",
    "hospital dictation systems"
  ]
}

​
Overview

This endpoint generates AI-suggested keywords to help refine and improve your search criteria for better discovery results.
Workflow Step: This is an optional refinement step in Phase 1 of the Market Research Workflow.

​
Usage

Use this endpoint to enhance your search criteria with AI-suggested keywords:
  • Refinement: Improve existing search criteria with better keywords
  • Discovery: Find relevant terms you might have missed
  • Optimization: Get more targeted and comprehensive search results

​
Best Practices

Optional Step: This endpoint is not required but can significantly improve your discovery results by suggesting relevant keywords you might not have considered.
Important: Review the suggested keywords carefully before using them in your discovery process. Not all suggestions may be relevant to your specific use case.

Authorizations

​
x-api-key
string
header
required

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

Body

application/json
​
searchCriteria
object
required

Response

Search criteria keywords generated

​
metadata
object
required
​
data
string[]
required

List of keywords for the search.