Skip to main content
GET
/
v2
/
discovery
/
{marketId}
/
search-criteria
/
history
Get search criteria history
curl --request GET \
  --url https://rest.forestreet.com/v2/discovery/{marketId}/search-criteria/history \
  --header 'x-api-key: <api-key>'
{
  "metadata": {
    "isFromPrimarySource": true
  },
  "data": [
    {
      "marketId": 12345,
      "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"
        ]
      },
      "count": 50,
      "locations": [
        {
          "country": "GB",
          "address": [
            "123 Healthcare St",
            "Suite 100"
          ],
          "coordinates": [
            51.5074,
            -0.1278
          ]
        }
      ],
      "jobId": 12345,
      "projectKind": "first_pass",
      "performSearch": true,
      "createdAt": "2023-01-15T10:30:00Z"
    },
    {
      "marketId": 12345,
      "marketName": "AI Transcription Services",
      "userPrompt": "Find AI transcription services",
      "marketType": "service",
      "marketRole": "serviceProvider",
      "keywords": {
        "features": [
          "AI transcription",
          "speech-to-text"
        ],
        "user": [
          "enterprise"
        ],
        "synonyms": [
          "transcription",
          "dictation"
        ],
        "irrelevant": [
          "manual transcription"
        ]
      },
      "count": 25,
      "locations": [
        {
          "country": "GB",
          "address": [
            "123 Healthcare St",
            "Suite 100"
          ],
          "coordinates": [
            51.5074,
            -0.1278
          ]
        }
      ],
      "jobId": 12345,
      "projectKind": "second_pass",
      "performSearch": false,
      "createdAt": "2023-01-15T10:30:00Z"
    }
  ]
}

​
Overview

This endpoint retrieves the complete history of search criteria iterations that have been used for a specific market discovery.
Workflow Step: This is part of Phase 3 (Company Review) of the Market Research Workflow.

​
Usage

Use this endpoint to track the evolution of search criteria for a market, which is helpful for:
  • Iteration: See how search criteria evolved over time
  • Documentation: Maintain a complete history of search parameters

​
Best Practices

Iteration Process: This endpoint is useful when you’ve refined your search criteria multiple times and want to track the progression.
Important: This endpoint only works for markets that have completed the discovery process. Make sure discovery is finished before calling this endpoint.

Authorizations

​
x-api-key
string
header
required

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

Path Parameters

​
marketId
string
required

Unique identifier for the market study.

Response

Search criteria history retrieved

​
metadata
object
required
​
data
object[]
required

Returned when querying markets with search criteria. Includes detailed market classifications and grouped keywords.