curl --request POST \
--url https://api.octen.ai/business-search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "Example Semiconductor quarterly results",
"count": 5
}
'{
"code": 0,
"msg": "success",
"request_id": "req_abc123def456",
"data": {
"query": "Example Semiconductor quarterly results",
"results": [
{
"title": "Example Semiconductor Announces Financial Results for Second Quarter Fiscal 2027",
"url": "https://investor.example-semiconductor.com/financial-info/financial-reports/",
"highlight": "Second-quarter revenue rose 106% from a year ago, with data center revenue up 117%...",
"time_published": "2026-08-26T00:00:00Z",
"time_last_crawled": "2026-10-13T01:31:46Z",
"favicon": "https://investor.example-semiconductor.com/favicon.ico"
}
],
"entities": [
{
"type": "company",
"name": "Example Semiconductor",
"summary": "Since its founding in 1993, Example Semiconductor has been a pioneer in accelerated computing. Its invention of the GPU in 1999 redefined computer graphics and ignited the era of modern AI...",
"aliases": [
"example semiconductor",
"example semiconductor corporation"
],
"identifiers": {
"website": "example-semiconductor.com",
"linkedin_url": "https://www.linkedin.com/company/example-semiconductor",
"stock_ticker": "XNAS:EXSC",
"sec_cik": "0001234567"
},
"attributes": {
"industry": "Computer Hardware Manufacturing",
"hq_location": "1 Example Parkway, Santa Clara, CA 95050, US",
"founded_year": 1993
},
"metrics": {
"financials": [
{
"revenue": 80000000000,
"net_income": 57000000000,
"gross_profit": 60000000000,
"period": "Q1, 2027",
"currency": "USD"
}
],
"stock": {
"price": 220,
"todays_change_percent": -2.11,
"week_52_high": 240,
"week_52_low": 160,
"date": "2026-10-12",
"currency": "USD"
},
"funding": [
{
"round": "Post-IPO Debt",
"amount": 25000000000,
"date": "2026-06-01",
"currency": "USD"
}
],
"web_traffic": {
"visits_monthly": 38000000,
"rank": 900,
"period": "2026-08"
}
},
"key_people": [
{
"name": "Alex Doe",
"title": "Founder, President and Chief Executive Officer"
}
],
"logo": {
"url": "https://cdn.example-cdn.com/logos/example-semiconductor.png"
},
"activities": [
{
"title": "A new beginning for Windows PCs",
"url": "https://www.linkedin.com/company/example-semiconductor/posts",
"highlight": "Join us at one of our launch events for demos on the new laptops...",
"authors": "Example Semiconductor",
"time_published": "2026-10-12T18:15:39Z"
}
],
"news": [
{
"title": "Chipmaker weighs buyback option in data centre listing dispute",
"url": "https://www.example-news.com/markets/data-centre-listing-dispute",
"highlight": "Confidential agreements put the AI infrastructure venture on a collision course with its own backers...",
"time_published": "2026-10-11T18:00:00Z",
"time_last_crawled": "2026-10-11T18:01:35Z",
"favicon": "https://www.example-news.com/favicon.ico",
"cover_image": {
"url": "https://cdn.example-news.com/2026/10/data-centre.png",
"description": "A data centre under construction."
}
}
]
}
]
},
"meta": {
"usage": {
"num_search_queries": 1
},
"latency": 229,
"warning": ""
}
}Octen Premier
Business Search API Reference
Searches the web for business content. The companies and people behind the query are also returned as entity cards.
POST
/
business-search
curl --request POST \
--url https://api.octen.ai/business-search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "Example Semiconductor quarterly results",
"count": 5
}
'{
"code": 0,
"msg": "success",
"request_id": "req_abc123def456",
"data": {
"query": "Example Semiconductor quarterly results",
"results": [
{
"title": "Example Semiconductor Announces Financial Results for Second Quarter Fiscal 2027",
"url": "https://investor.example-semiconductor.com/financial-info/financial-reports/",
"highlight": "Second-quarter revenue rose 106% from a year ago, with data center revenue up 117%...",
"time_published": "2026-08-26T00:00:00Z",
"time_last_crawled": "2026-10-13T01:31:46Z",
"favicon": "https://investor.example-semiconductor.com/favicon.ico"
}
],
"entities": [
{
"type": "company",
"name": "Example Semiconductor",
"summary": "Since its founding in 1993, Example Semiconductor has been a pioneer in accelerated computing. Its invention of the GPU in 1999 redefined computer graphics and ignited the era of modern AI...",
"aliases": [
"example semiconductor",
"example semiconductor corporation"
],
"identifiers": {
"website": "example-semiconductor.com",
"linkedin_url": "https://www.linkedin.com/company/example-semiconductor",
"stock_ticker": "XNAS:EXSC",
"sec_cik": "0001234567"
},
"attributes": {
"industry": "Computer Hardware Manufacturing",
"hq_location": "1 Example Parkway, Santa Clara, CA 95050, US",
"founded_year": 1993
},
"metrics": {
"financials": [
{
"revenue": 80000000000,
"net_income": 57000000000,
"gross_profit": 60000000000,
"period": "Q1, 2027",
"currency": "USD"
}
],
"stock": {
"price": 220,
"todays_change_percent": -2.11,
"week_52_high": 240,
"week_52_low": 160,
"date": "2026-10-12",
"currency": "USD"
},
"funding": [
{
"round": "Post-IPO Debt",
"amount": 25000000000,
"date": "2026-06-01",
"currency": "USD"
}
],
"web_traffic": {
"visits_monthly": 38000000,
"rank": 900,
"period": "2026-08"
}
},
"key_people": [
{
"name": "Alex Doe",
"title": "Founder, President and Chief Executive Officer"
}
],
"logo": {
"url": "https://cdn.example-cdn.com/logos/example-semiconductor.png"
},
"activities": [
{
"title": "A new beginning for Windows PCs",
"url": "https://www.linkedin.com/company/example-semiconductor/posts",
"highlight": "Join us at one of our launch events for demos on the new laptops...",
"authors": "Example Semiconductor",
"time_published": "2026-10-12T18:15:39Z"
}
],
"news": [
{
"title": "Chipmaker weighs buyback option in data centre listing dispute",
"url": "https://www.example-news.com/markets/data-centre-listing-dispute",
"highlight": "Confidential agreements put the AI infrastructure venture on a collision course with its own backers...",
"time_published": "2026-10-11T18:00:00Z",
"time_last_crawled": "2026-10-11T18:01:35Z",
"favicon": "https://www.example-news.com/favicon.ico",
"cover_image": {
"url": "https://cdn.example-news.com/2026/10/data-centre.png",
"description": "A data centre under construction."
}
}
]
}
]
},
"meta": {
"usage": {
"num_search_queries": 1
},
"latency": 229,
"warning": ""
}
}Authorizations
bearerAuthNoPaymentapiKeyAuthNoPayment
Body
application/json
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:
1200Maximum string length:
60Example:
["spam.com", "ads.example.net"]
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 Response
Successful business search response
Was this page helpful?