Business Search

curl --request POST \
  --url https://api.octen.ai/business-search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "NVIDIA quarterly results",
  "count": 5
}
'

{
  "code": 0,
  "msg": "success",
  "request_id": "req_abc123def456",
  "data": {
    "query": "NVIDIA quarterly results",
    "results": [
      {
        "title": "NVIDIA Announces Financial Results for Fourth Quarter and Fiscal 2026 | NVIDIA Newsroom",
        "url": "https://nvidianews.nvidia.com/news/nvidia-announces-financial-results-for-fourth-quarter-and-fiscal-2026",
        "highlight": "NVIDIA (NASDAQ: NVDA) today reported record revenue for the fourth quarter ended January 25, 2026...",
        "time_published": "2026-02-25T00:00:00Z",
        "time_last_crawled": "2026-09-23T01:25:05Z",
        "favicon": "https://nvidianews.nvidia.com/media/sites/219/images/itouch.png",
        "cover_image": {
          "url": "https://iprsoftwaremedia.com/219/files/20224/DH1L4415-HDR-20220527-r5-prv.jpg",
          "description": "NVIDIA Voyager"
        }
      }
    ],
    "entities": [
      {
        "type": "company",
        "name": "NVIDIA",
        "summary": "Since its founding in 1993, NVIDIA (NASDAQ: NVDA) has been a pioneer in accelerated computing. The company's invention of the GPU in 1999 sparked the growth of the PC gaming market, redefined computer graphics, ignited the era of modern AI and is fueling the creation of the metaverse.",
        "aliases": [
          "nvidia",
          "nvidia corporation"
        ],
        "identifiers": {
          "website": "nvidia.com",
          "linkedin_url": "https://www.linkedin.com/company/nvidia",
          "stock_ticker": "NASDAQ:NVDA",
          "sec_cik": "0001045810"
        },
        "attributes": {
          "industry": "Computer Hardware Manufacturing",
          "hq_location": "2701 San Tomas Expressway, Santa Clara, CA 95050, US",
          "founded_year": 1993
        },
        "metrics": {
          "financials": [
            {
              "revenue": 81615003648,
              "net_income": 58320998400,
              "gross_profit": 61156999168,
              "period": "Q1, 2027",
              "currency": "USD"
            },
            {
              "revenue": 215938007040,
              "net_income": 120066998272,
              "gross_profit": 153462996992,
              "period": "FY, 2026",
              "currency": "USD"
            }
          ],
          "stock": {
            "price": 230.43,
            "todays_change_percent": 2.381478132712727,
            "week_52_high": 236.53999,
            "week_52_low": 164.27,
            "date": "2026-09-28",
            "currency": "USD"
          },
          "web_traffic": {
            "visits_monthly": 38505903,
            "rank": 903,
            "period": "2026-08"
          }
        },
        "key_people": [
          {
            "name": "Jensen Huang",
            "title": "Founder and CEO"
          },
          {
            "name": "Colette Kress",
            "title": "EVP CFO"
          }
        ],
        "logo": {
          "url": "https://media.licdn.com/dms/image/v2/D560BAQGV36q2EowSyw/company-logo_200_200/0/1724881581208/nvidia_logo"
        },
        "activities": [
          {
            "title": "AI is technology that is built and improved by people, who have a responsibility to develop and deploy it thoughtfully.",
            "url": "https://www.linkedin.com/feed/update/urn:li:activity:7508569677040893954/",
            "highlight": "And helping people benefit from AI means taking its challenges seriously. The technology industry needs to do that work...",
            "authors": "NVIDIA",
            "time_published": "2026-09-23T16:55:13Z"
          }
        ]
      }
    ]
  },
  "meta": {
    "usage": {
      "num_search_queries": 1
    },
    "latency": 235,
    "warning": ""
  }
}

POST

business-search

curl --request POST \
  --url https://api.octen.ai/business-search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "NVIDIA quarterly results",
  "count": 5
}
'

{
  "code": 0,
  "msg": "success",
  "request_id": "req_abc123def456",
  "data": {
    "query": "NVIDIA quarterly results",
    "results": [
      {
        "title": "NVIDIA Announces Financial Results for Fourth Quarter and Fiscal 2026 | NVIDIA Newsroom",
        "url": "https://nvidianews.nvidia.com/news/nvidia-announces-financial-results-for-fourth-quarter-and-fiscal-2026",
        "highlight": "NVIDIA (NASDAQ: NVDA) today reported record revenue for the fourth quarter ended January 25, 2026...",
        "time_published": "2026-02-25T00:00:00Z",
        "time_last_crawled": "2026-09-23T01:25:05Z",
        "favicon": "https://nvidianews.nvidia.com/media/sites/219/images/itouch.png",
        "cover_image": {
          "url": "https://iprsoftwaremedia.com/219/files/20224/DH1L4415-HDR-20220527-r5-prv.jpg",
          "description": "NVIDIA Voyager"
        }
      }
    ],
    "entities": [
      {
        "type": "company",
        "name": "NVIDIA",
        "summary": "Since its founding in 1993, NVIDIA (NASDAQ: NVDA) has been a pioneer in accelerated computing. The company's invention of the GPU in 1999 sparked the growth of the PC gaming market, redefined computer graphics, ignited the era of modern AI and is fueling the creation of the metaverse.",
        "aliases": [
          "nvidia",
          "nvidia corporation"
        ],
        "identifiers": {
          "website": "nvidia.com",
          "linkedin_url": "https://www.linkedin.com/company/nvidia",
          "stock_ticker": "NASDAQ:NVDA",
          "sec_cik": "0001045810"
        },
        "attributes": {
          "industry": "Computer Hardware Manufacturing",
          "hq_location": "2701 San Tomas Expressway, Santa Clara, CA 95050, US",
          "founded_year": 1993
        },
        "metrics": {
          "financials": [
            {
              "revenue": 81615003648,
              "net_income": 58320998400,
              "gross_profit": 61156999168,
              "period": "Q1, 2027",
              "currency": "USD"
            },
            {
              "revenue": 215938007040,
              "net_income": 120066998272,
              "gross_profit": 153462996992,
              "period": "FY, 2026",
              "currency": "USD"
            }
          ],
          "stock": {
            "price": 230.43,
            "todays_change_percent": 2.381478132712727,
            "week_52_high": 236.53999,
            "week_52_low": 164.27,
            "date": "2026-09-28",
            "currency": "USD"
          },
          "web_traffic": {
            "visits_monthly": 38505903,
            "rank": 903,
            "period": "2026-08"
          }
        },
        "key_people": [
          {
            "name": "Jensen Huang",
            "title": "Founder and CEO"
          },
          {
            "name": "Colette Kress",
            "title": "EVP CFO"
          }
        ],
        "logo": {
          "url": "https://media.licdn.com/dms/image/v2/D560BAQGV36q2EowSyw/company-logo_200_200/0/1724881581208/nvidia_logo"
        },
        "activities": [
          {
            "title": "AI is technology that is built and improved by people, who have a responsibility to develop and deploy it thoughtfully.",
            "url": "https://www.linkedin.com/feed/update/urn:li:activity:7508569677040893954/",
            "highlight": "And helping people benefit from AI means taking its challenges seriously. The technology industry needs to do that work...",
            "authors": "NVIDIA",
            "time_published": "2026-09-23T16:55:13Z"
          }
        ]
      }
    ]
  },
  "meta": {
    "usage": {
      "num_search_queries": 1
    },
    "latency": 235,
    "warning": ""
  }
}

Authorizations

Authorization

string

header

required

Bearer token used for request authentication. Alternatively, you can send the API key in the x-api-key header.

Body

application/json

query

string

required

The search query.

Operators

site:<domain>: restrict results to a single domain. For multiple domains, use include_domains and exclude_domains.
-site:<domain>: exclude a single domain from the results.

Maximum string length: 500

count

integer

default:5

Number of results to return.

Required range: 1 <= x <= 100

include_domains

string[]

A list of domains to specifically include in the search results. The site: query operator adds to this list. Applies to results only; entity cards do not support domain filtering.

Maximum array length: 1200

Maximum string length: 60

Example:

["reuters.com", "bloomberg.com"]

exclude_domains

string[]

A list of domains to specifically exclude from the search results. The -site: query operator adds to this list. If a domain appears in both include_domains and exclude_domains, exclude_domains takes precedence. Applies to results only; entity cards do not support domain filtering.

Maximum array length: 1200

Maximum string length: 60

Example:

["spam.com", "ads.example.net"]

time_basis

enum<string>

default:auto

Determines which time field is used for time filtering. published uses time_published; crawled uses time_last_crawled. Results missing this field are excluded when filtering by time. Applies to results only; entity cards do not support time filtering.

Available options:

auto,

published,

crawled

time_range

enum<string>

Relative time window counting back from the current time based on time_basis. Mutually exclusive with start_time/end_time: if both are provided, start_time/end_time take precedence.

Available options:

day,

week,

month,

year,

d,

w,

m,

y

start_time

string<date-time>

Start time for filtering results. ISO 8601 format.

Example:

"2026-08-22T00:00:00Z"

end_time

string<date-time>

End time for filtering results. ISO 8601 format.

Example:

"2026-08-24T00:00:00Z"

language

enum<string>[]

A list of languages to restrict results to, as ISO 639-1 codes.

Available options:

ar,

de,

en,

es,

fr,

hi,

id,

it,

ja,

ko,

nl,

pl,

pt,

ru,

th,

tr,

vi,

zh

Example:

["en", "zh"]

highlight

object

Controls highlight extraction from result pages.

Show child attributes

full_content

object

Controls whether to return the full raw content of each result page.

Show child attributes

entities

object

Controls the entity cards returned for companies and people.

Show child attributes

Response

Successful business search response

code

integer

Business status code. 0 indicates success.

msg

string

A message describing the result.

request_id

string

The unique identifier for this request.

data

object

The main response payload. Fields without data are omitted, at every level.

Show child attributes

APIs

Applications

Authorizations

Body

Response