Scout Search API | Harmonic Guides

Overview

The Scout Search API lets you search Harmonic's 30M+ company database using natural language queries. Describe what you're looking for, and Scout API returns relevant companies matching your criteria.

Note: This API returns search results only. For the full Scout experience, including research reports, templates, and company-specific Q&A, use Scout in the Harmonic console.

Authentication

You'll need an active Harmonic API key. Find yours in the "Manage API Keys" section of your Harmonic dashboard.

Endpoint

GET https://api.harmonic.ai/search/search_agent

Request parameters

Parameter	Type	Required	Description
`query`	string	Yes	Your natural language search query
`similarity_threshold`	float	No	Minimum similarity score for results (0.0 to 1.0). When not set, the threshold is determined dynamically based on the query. We do not recommend setting this unless you have a strong need, since if it is set you will not benefit from our dynamic setting.
`size`	integer	No	Maximum number of results to return. Default: 25

Query guidelines

Reference companies using:

Name: companies like Harmonic
Domain: companies similar to harmonic.ai
URL: companies similar to https://www.harmonic.ai
Multiple companies: companies like ramp.com or brex.com

Example queries:

LLM prompt engineering tools similar to langfuse.com with recent growth
Series B software companies with >$10M in funding focused on financial services
robotics companies building automation like covariant.ai
climate tech startups with employees from GE Renewable Energy
early stage healthcare startups with enterprise traction in last 6 months
companies founded by ex-Google employees

Tips for better results:

Be specific about company stage, funding, sector, and other criteria
Reference similar companies to narrow your search space
Include relevant growth indicators or traction signals
The more context you provide, the better the results

Example

Request

bash

curl -X GET \
  'https://api.harmonic.ai/search/search_agent?query=payment%20processing%20startups%20with%20at%20least%205m%20in%20funding&similarity_threshold=0.5&size=25' \
  -H 'accept: application/json' \
  -H 'apikey: YOUR_API_KEY'

Response

json

{
  "count": 885,
  "page_info": {
    "next": "page_2_token",
    "current": null,
    "has_next": true
  },
  "results": [
    {
      "urn": "urn:harmonic:company:123456",
      "cursor": "result_1_position"
    },
    {
      "urn": "urn:harmonic:company:789012",
      "cursor": "result_2_position"
    }
  ],
  "query_interpretation": {
    "semantic": "payment processing startups offering innovative solutions for secure transactions, fraud prevention, and seamless integration with e-commerce platforms",
    "faceted": [
      {
        "field_name": "funding_total",
        "operator": "greaterThanOrEquals",
        "filter_value": 5000000,
        "parsed_text": "at least 5m in funding"
      }
    ],
    "preserved_semantic_input": "payment processing startups",
    "companies": null,
    "unprocessable_query_part": "",
    "parser_version": "v1"
  }
}

Response fields

Field	Description
`count`	Total number of matching companies
`page_info`	Pagination information including next page token
`results`	Array of matching companies with URNs and cursors
`query_interpretation`	How the API interpreted your query, including semantic expansion and extracted filters

Query interpretation

Scout automatically interprets your natural language query and breaks it down into:

Semantic query - The type of company/product you're looking for, expanded for better matching

Faceted filters - Structured filters extracted from your query:

"raised more than $5M" → funding_total filter
"growing fast" → headcount growth filter
"Series B" → funding stage filter

Referenced companies - Specific companies you mentioned to narrow the search space

Unprocessable parts - Any query portions that couldn't be interpreted

Data fields

Scout searches across all Harmonic company data fields. See the complete Harmonic Data Fields documentation for available fields and filters.

Pagination

Use the next token from page_info to retrieve additional results:

bash

curl -X GET \
  'https://api.harmonic.ai/search/search_agent?query=YOUR_QUERY&page_token=PAGE_TOKEN' \
  -H 'accept: application/json' \
  -H 'apikey: YOUR_API_KEY'

Rate limits

Standard Harmonic API rate limits apply. See API Documentation for details.

Support

Questions or issues? Contact support@harmonic.ai

Zapier Custom Workflow: Get Search Results

Discover Companies and Peoples with Searches

Semantic Keywords

Scout - Your AI Research Agent

Scout Search & Evaluate