メインコンテンツへスキップ
Olostep の /v1/searches エンドポイントを使用すると、自然言語クエリでウェブを検索し、重複を排除した関連リンクのリストをタイトルと説明付きで取得できます。
  • クエリを英語で送信
  • ウェブ全体から構造化されたリンクを取得
クエリをウェブ全体で意味的に検索し、結果を返します。 API の詳細については、検索エンドポイント API リファレンスを参照してください。

インストール

# pip install requests

import requests

使用方法

自然言語クエリを送信し、関連リンクのリストを受け取ります。
import requests, json

endpoint = "https://api.olostep.com/v1/searches"
payload = {
  "query": "Best Answer Engine Optimization startups"
}
headers = {"Authorization": "Bearer <YOUR_API_KEY>", "Content-Type": "application/json"}

response = requests.post(endpoint, json=payload, headers=headers)
print(json.dumps(response.json(), indent=2))

レスポンス

レスポンスとして search オブジェクトを受け取ります。search オブジェクトには id、元の query、および links のリストを含む result が含まれています。
{
  "id": "search_9bi0sbj9xa",
  "object": "search",
  "created": 1760327323,
  "metadata": {},
  "query": "Best Answer Engine Optimization startups",
  "result": {
    "json_content": "...",
    "json_hosted_url": "https://olostep-storage.s3.us-east-1.amazonaws.com/search_9bi0sbj9xa.json",
    "links": [
      {
        "url": "https://www.adweek.com/media/hottest-startups-shaping-the-future-of-ai-search-optimization-aeo-geo/",
        "title": "Meet the 7 Hottest Startups Shaping the Future of AI SEO",
        "description": "1. Profound · 2. Bluefish · 3. Scrunch · 4. Evertune · 5. Peec AI · 6. Brandlight · 7. AthenaHQ."
      },
      {
        "url": "https://www.failory.com/startups/search-engine",
        "title": "Top 48 Search Engine Startups to Watch in 2026",
        "description": "A deep dive into the 48 most promising search engine startups..."
      },
      {
        "url": "https://clutch.co/seo-firms/startups",
        "title": "Top 30 SEO Companies for Startups - Mar 2026 Rankings",
        "description": "Connect with the best SEO companies..."
      }
    ]
  }
}
result.links の各リンクには以下が含まれます:
フィールドタイプ説明
urlstring検索結果の URL
titlestring結果ページのタイトル
descriptionstring結果を説明する短いスニペット
完全な結果は、result.json_hosted_url でホストされた JSON ファイルとしても利用可能です。

料金

検索はリクエストごとに 5 クレジットかかります。