このサービスの目的は、世界中のすべての商品を1か所に集め、API経由でストアにアクセスできるようにすることです。ここでは、価格のダイナミクス、誰が何を販売するかなどを確認できます（現在、3500万以上の製品がインデックスに登録されています）。 Google Search API for Shoppingが「廃止」された後、Semantics3は急速に勢いを増しています。 彼は、2013年冬季セッションのY Combinatorファンドの7つのベストスタートアップの 1つです。
はじめに
まず、APIを使用するためのキーを取得するには、サイトでアカウントをアカウントに登録する必要があります。 その後、4つの料金プランのいずれかを選択できます。 GitHubアカウントを介してログインしました-APIキーとAPIシークレットを取得し、1日あたり1000リクエストの制限がある無料プランを選択しました。
APIリクエストは3つのコンポーネントで構成されています。
たとえば、URL：
（https://api.semantics3.com/v1- エンドポイントAPI
/製品？ - リソース
q = {"cat_id"：13658、 "brand"： "Toshiba"、 "model"： "Satellite"}）- クエリパラメーター
エンドポイントAPIは、使用するサービスのバージョンです。 本番（https://api.semantics3.com/v1）とテスト/開発（https://api.semantics3.com/test/v1）に分かれています。 認証方法と1日あたりのAPI呼び出し数の制限によって異なります。 テストの場合、これは基本認証（Curlを使用する機能）であり、100コール/日という制限です。 実稼働環境では、選択した料金プランに応じて、OAuth v1.0 2の認証と制限が使用されます。
リソース -APIを使用して、製品（/製品）およびカテゴリ（/カテゴリ）を取得できます。すべての製品は、ツリー構造のカテゴリ（cat_id）に編成されています-
たとえば、カテゴリ「Electronics」（cat_id 13658）には、「Computers＆Accessories」（cat_id 4992）を含むいくつかの子カテゴリが含まれ、さらに子カテゴリ「Scanners」（cat_id 14047）が含まれます。
クエリパラメータ -検索クエリはJSON文字列として表されます。 最大50個の異なるフィールドを使用して、非常に柔軟なクエリを作成できます。
APIライブラリ
開発中、検索クエリのテスト中に、Curlユーティリティを使用できます。
curl -G -H "api_key: SEM3E892B8487C7EA8267E1B0C8CE8345157" https://api.semantics3.com/test/v1/products --data-urlencode 'q={"cat_id":13658,"brand":"Toshiba","model":"Satellite"}'
一般に、Sematic3はProduction APIにアクセスするためのいくつかのライブラリをリリースしました。
Perl、Python、PHP、Node.js、Ruby、Java、およびC＃での実装。
以下は、Rubyでsmantics3 gemを使用した例です。
require 'rubygems' require 'semantics3' API_KEY = 'SEM3xxxxxxxxxxxxxxxxxx' API_SECRET = 'xxxxxxxxxxxxxxxxxxxxxxxx' sem3 = Semantics3::Products.new(API_KEY,API_SECRET) sem3.products_field( "cat_id", 4992 ) sem3.products_field( "brand", "Toshiba" ) productsHash = sem3.get_products puts "Results of query:\n",productsHash.to_json
これにより、Netbooksカテゴリのトップ10東芝ブランド製品のリストが表示されます。 リストはJSON形式で表示されます。各製品には、「名前」、「価格」、「img」（基本料金プランでは利用不可）、「url」（サプライヤーのWebサイトのアドレス）などのフィールドがあります。製品リストページ。
検索クエリの例は 、ドキュメントに記載されています。
また、無料の料金プランであっても、迅速かつ迅速なサポートについて言及したいと思います。 プロジェクトの開発中に質問があったとき、Semantic3のメンバーがすぐにソリューションを手伝いました。