---
title: "Search Agent"
method: GET
path: "/search/search_agent"
tags: ["companies", "people", "search"]
---

# Search Agent

`GET /search/search_agent`

## Query parameters

- `query` string, required
- `similarity_threshold` number, nullable — Similarity threshold
- `size` integer — Page size
- `cursor` string, nullable — Cursor for pagination

## Response `200`

Successful Response

- SearchAgentCursorSearchOutput
  - `count` integer, nullable
  - `page_info` PaginationMetadata
    - `next` string, nullable
    - `current` string, nullable
    - `has_next` boolean, required
  - `results` SearchResultCompanyUrn[], required
    - `urn` string, required
    - `cursor` string, nullable
  - `query_interpretation` ParsedQueryModelOutput, required
    - `semantic` string, nullable
    - `faceted` FacetModel[], nullable
      - `field_name` string, required
      - `operator` string, required
      - `filter_value` unknown, required
      - `parsed_text` string, nullable
    - `preserved_semantic_input` string, nullable
    - `companies` CompaniesModel[], nullable
      - `company_name` string, required
      - `company_urn` string, required
      - `inclusion` 'include' | 'exclude' | 'filter', required
      - `parsed_text` string, nullable
    - `unprocessable_query_part` string, nullable
    - `similarity` number, nullable
    - `filter_str_repr` string, nullable
    - `api_request` LimitedApiRequestModelOutput
      - `filter_group` FilterGroupOutput
        - `join_operator` 'and' | 'or', required
        - `filters` Filter[], nullable
          - `field` string, required
          - `field_urn` string, nullable
          - `comparator` string, required
          - `filter_value` unknown
        - `filter_groups` FilterGroupOutput[], nullable
        - `filter_group_generators` FilterGroupGenerator[], nullable
          - `generator_id` 'company_headcount' | 'search_v2_accelerator' | 'search_v2_company_funding_stage' | 'search_v2_company_funding_stage_simple' | 'search_v2_company_funding_total_range' | 'search_v2_company_funding_last_round_total_range' | 'search_v2_company_funding_undisclosed' | 'search_v2_company_currently_raising' | 'search_v2_company_funding_include_investors' | 'search_v2_company_funding_exclude_investors' | 'search_v2_company_funding_last_round_date' | 'search_v2_company_funding_foundation_date' | 'search_v2_company_funding_investors_deal_search' | 'search_v2_company_team_headcount_range' | 'search_v2_company_team_headcount_percent_growth_range' | 'search_v2_company_latest_web_traffic_range' | 'search_v2_company_web_traffic_percent_growth_range' | 'search_v2_company_headcount_department_percent_growth_range' | 'search_v2_company_socials_growth_range' | 'search_v2_company_team_highlights' | 'search_v2_company_sector_include_keywords' | 'search_v2_company_sector_exclude_keywords' | 'search_v2_company_sector_match_keywords' | 'search_v2_company_sector_include_industry_tags' | 'search_v2_company_sector_exclude_industry_tags' | 'search_v2_company_sector_include_business_tags' | 'search_v2_company_sector_exclude_business_tags' | 'search_v2_company_sector_include_technology_tags' | 'search_v2_company_sector_exclude_technology_tags' | 'search_v2_company_sector_preset' | 'search_v2_company_sector_include_tags' | 'search_v2_company_sector_exclude_tags' | 'search_v2_company_sector_product_categories' | 'search_v2_company_team_founding_experience' | 'search_v2_company_team_member_experience' | 'search_v2_company_team_notable_followers' | 'search_v2_company_team_notable_followers_count' | 'search_v2_company_list_and_more_initialized_date' | 'search_v2_company_list_and_more_updated_date' | 'search_v2_company_list_and_more_include_from_watchlist' | 'search_v2_company_list_and_more_exclude_from_watchlist' | 'search_v2_company_list_and_more_accelerators' | 'search_v2_company_list_and_more_location' | 'search_v2_company_list_and_more_continents' | 'search_v2_company_list_and_more_include_from_people_list' | 'search_v2_company_list_and_more_exclude_from_people_list' | 'search_v2_company_is_not_investor' | 'search_people_employees' | 'search_v2_people_education_experience' | 'search_v2_people_general_highlights' | 'search_v2_people_general_location' | 'search_v2_people_general_connections' | 'search_v2_people_general_linkedin_headlines' | 'search_v2_people_general_people_lists' | 'search_v2_people_current_experience' | 'search_v2_people_past_experience' | 'search_v2_people_general_correspondences' | 'search_v2_person_notable_followers' | 'search_v2_person_notable_followers_count' | 'search_v2_company_team_correspondences' | 'search_v2_semantic_search_filter' | 'search_v2_similar_company_search_filter' | 'search_v2_investor_aum_range' | 'search_v2_investor_check_size_range' | 'search_v2_investor_funded_company_location' | 'search_v2_investor_invested_stage' | 'search_v2_investor_latest_investment_date' | 'search_v2_investor_location' | 'search_v2_investor_num_deals_range' | 'search_v2_investor_team_size_range' | 'search_v2_investor_co_investors' | 'search_v2_investor_average_investment_size_range' | 'search_v2_investor_entry_stage_focus' | 'search_v2_investor_country_focus' | 'search_v2_investor_sector_focus' | 'search_v2_investor_funded_company' | 'search_v2_investor_website_keywords' | 'search_v2_investor_funded_company_sector_tags' | 'search_v2_investor_portfolio_details' | 'search_v2_investor_team_correspondences' | 'search_v2_investor_lists' | 'search_v2_investor_type' | 'search_v2_investor_primary_type' | 'search_v2_investor_secondary_types', required
          - `arguments` object, required
      - `controlled_filter_group` FilterGroupOutput
        - `join_operator` 'and' | 'or', required
        - `filters` Filter[], nullable
          - `field` string, required
          - `field_urn` string, nullable
          - `comparator` string, required
          - `filter_value` unknown
        - `filter_groups` FilterGroupOutput[], nullable
        - `filter_group_generators` FilterGroupGenerator[], nullable
          - `generator_id` 'company_headcount' | 'search_v2_accelerator' | 'search_v2_company_funding_stage' | 'search_v2_company_funding_stage_simple' | 'search_v2_company_funding_total_range' | 'search_v2_company_funding_last_round_total_range' | 'search_v2_company_funding_undisclosed' | 'search_v2_company_currently_raising' | 'search_v2_company_funding_include_investors' | 'search_v2_company_funding_exclude_investors' | 'search_v2_company_funding_last_round_date' | 'search_v2_company_funding_foundation_date' | 'search_v2_company_funding_investors_deal_search' | 'search_v2_company_team_headcount_range' | 'search_v2_company_team_headcount_percent_growth_range' | 'search_v2_company_latest_web_traffic_range' | 'search_v2_company_web_traffic_percent_growth_range' | 'search_v2_company_headcount_department_percent_growth_range' | 'search_v2_company_socials_growth_range' | 'search_v2_company_team_highlights' | 'search_v2_company_sector_include_keywords' | 'search_v2_company_sector_exclude_keywords' | 'search_v2_company_sector_match_keywords' | 'search_v2_company_sector_include_industry_tags' | 'search_v2_company_sector_exclude_industry_tags' | 'search_v2_company_sector_include_business_tags' | 'search_v2_company_sector_exclude_business_tags' | 'search_v2_company_sector_include_technology_tags' | 'search_v2_company_sector_exclude_technology_tags' | 'search_v2_company_sector_preset' | 'search_v2_company_sector_include_tags' | 'search_v2_company_sector_exclude_tags' | 'search_v2_company_sector_product_categories' | 'search_v2_company_team_founding_experience' | 'search_v2_company_team_member_experience' | 'search_v2_company_team_notable_followers' | 'search_v2_company_team_notable_followers_count' | 'search_v2_company_list_and_more_initialized_date' | 'search_v2_company_list_and_more_updated_date' | 'search_v2_company_list_and_more_include_from_watchlist' | 'search_v2_company_list_and_more_exclude_from_watchlist' | 'search_v2_company_list_and_more_accelerators' | 'search_v2_company_list_and_more_location' | 'search_v2_company_list_and_more_continents' | 'search_v2_company_list_and_more_include_from_people_list' | 'search_v2_company_list_and_more_exclude_from_people_list' | 'search_v2_company_is_not_investor' | 'search_people_employees' | 'search_v2_people_education_experience' | 'search_v2_people_general_highlights' | 'search_v2_people_general_location' | 'search_v2_people_general_connections' | 'search_v2_people_general_linkedin_headlines' | 'search_v2_people_general_people_lists' | 'search_v2_people_current_experience' | 'search_v2_people_past_experience' | 'search_v2_people_general_correspondences' | 'search_v2_person_notable_followers' | 'search_v2_person_notable_followers_count' | 'search_v2_company_team_correspondences' | 'search_v2_semantic_search_filter' | 'search_v2_similar_company_search_filter' | 'search_v2_investor_aum_range' | 'search_v2_investor_check_size_range' | 'search_v2_investor_funded_company_location' | 'search_v2_investor_invested_stage' | 'search_v2_investor_latest_investment_date' | 'search_v2_investor_location' | 'search_v2_investor_num_deals_range' | 'search_v2_investor_team_size_range' | 'search_v2_investor_co_investors' | 'search_v2_investor_average_investment_size_range' | 'search_v2_investor_entry_stage_focus' | 'search_v2_investor_country_focus' | 'search_v2_investor_sector_focus' | 'search_v2_investor_funded_company' | 'search_v2_investor_website_keywords' | 'search_v2_investor_funded_company_sector_tags' | 'search_v2_investor_portfolio_details' | 'search_v2_investor_team_correspondences' | 'search_v2_investor_lists' | 'search_v2_investor_type' | 'search_v2_investor_primary_type' | 'search_v2_investor_secondary_types', required
          - `arguments` object, required
    - `query_translations` string[], nullable
    - `parser_version` 'v1' | 'v2' | 'v3' | 'v4'

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/harmonic/apis/harmonic-ai-public-api.md) · [All operations](https://skmtc.net/harmonic/apis/harmonic-ai-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/harmonic/harmonic-ai-public-api/revisions/0edae4154f8f/schema)