GET
/
v1
/
companies
/
search
Search Companies
curl --request GET \
  --url https://api.extruct.ai/v1/companies/search \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "id": "<string>",
      "domain": "<string>",
      "name": "<string>",
      "short_description": "<string>",
      "full_description": "<string>",
      "products_services": "<string>",
      "use_cases": "<string>",
      "target_audience": "<string>",
      "other_considerations": "<string>",
      "business_types": [
        "<string>"
      ],
      "target_markets": [
        "<string>"
      ],
      "industry_tags": [
        "<string>"
      ],
      "founding_year": 123,
      "employee_count": "<string>",
      "hq_country": "<string>",
      "hq_state_province": "<string>",
      "hq_city": "<string>",
      "hq_full_address": "<string>",
      "social_profiles": {},
      "website_authority": {
        "score": 123,
        "percentile": 123,
        "tier": "<string>",
        "tier_label": "<string>"
      },
      "relevance_score": 123
    }
  ],
  "facet_counts": [
    {
      "field_name": "<string>",
      "counts": [
        {}
      ],
      "stats": {}
    }
  ],
  "request": {
    "query": "<string>",
    "page": 123,
    "per_page": 123,
    "text_weight": 123,
    "filters": {
      "include": {},
      "exclude": {},
      "range": {}
    },
    "reference_company_id": "<string>"
  }
}
The endpoint allows you to search for companies using Extruct AI’s semantic search capabilities. The search is performed across all tables in your workspace.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

q
string
required

Search query

scope
enum<string> | null

Filter by ownership scope (personal/organization) Search scope for filtering companies by ownership

Available options:
personal,
organization
filters
string | null

JSON string of SearchFilters object

text_weight
number
default:0.5

Text weight for hybrid search

Required range: 0 <= x <= 1
page
integer
default:1

Page number

Required range: x >= 1
per_page
integer
default:20

Results per page

Required range: 1 <= x <= 100

Response

Successful Response

Main company search response wrapper.

results
CompanySearchResult · object[]
required

Search results

request
object
required

Request parameters echo

facet_counts
FacetCount · object[]

Facet aggregations