Skip to main content
Start with the path that matches what you are building.

Call the API

Install Agent Skills

Connect an MCP client

Use the Python SDK

​
Get Your API Key

Create an account in the Octen API Platform.
A payment method is required to use the API.

​
Make Your First Search Request

curl -X POST https://api.octen.ai/search \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "query": "latest AI developments",
    "count": 5
  }'
Example response: 
{
  "code": 0,
  "msg": "success",
  "data": {
    "query": "latest AI developments",
    "results": [
      {
        "title": "Example AI news result",
        "url": "https://example.com/ai-news",
        "highlight": "Recent developments in artificial intelligence...",
        "time_published": "2026-06-20T00:00:00Z",
        "time_last_crawled": "2026-06-23T08:30:05Z"
      }
    ]
  }
}

​
Install Agent Skills

Use Octen Skills when your agent supports SKILL.md-based Agent Skills. 
npx skills add Octen-Team/web-search-skills

​
Connect an MCP Client

Use Octen MCP when your client supports MCP tools. 
{
  "mcpServers": {
    "octen": {
      "command": "npx",
      "args": ["-y", "octen-mcp"],
      "env": {
        "OCTEN_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

​
Use the Python SDK

Install the SDK: 
pip install octen

​
Next Steps

API Reference

View all API parameters and options

Examples

Explore more use cases

Support

Get help from our team

API Platform

Manage your API keys