プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Craigslistの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | 指定した都市とセクションでCraigslistの広告を検索し、各投稿のタイトル、価格、所在地、日付、座標、画像、掲載された連絡先を取得します。名前に反してcountryはnewyorkやsfbayなどの都市サイトを指定するパラメータで、認識できないregionの値はニューヨークにフォールバックします。 | 1,000リクエストあたり$1.39 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Craigslistの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索 指定した都市とセクションでCraigslistの広告を検索し、各投稿のタイトル、価格、所在地、日付、座標、画像、掲載された連絡先を取得します。名前に反して | keyword | category, country, location, max_price, min_price, region, sort | Sync配信 | カタログ値：defaultLimit=20、maxLimit=200。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · title · text · price · currency · category · location · posted_at · lat · lng · emails · phones · images · platform |
Craigslistのsearchのパラメータはそれぞれどういう意味ですか？
指定した都市とセクションでCraigslistの広告を検索し、各投稿のタイトル、価格、所在地、日付、座標、画像、掲載された連絡先を取得します。名前に反してcountryはnewyorkやsfbayなどの都市サイトを指定するパラメータで、認識できないregionの値はニューヨークにフォールバックします。
keyword必須- Craigslistのクラシファイド広告を検索するキーワードを指定します（例：bicycle）。返される出品は選択したカテゴリによって決まるため、同じキーワードで販売、住宅、求人を検索できます。
category任意- 出品カテゴリのスラッグを指定します：for_sale（デフォルト）、cars_trucks、electronics、furniture、housing_apartments_houses、housing_rooms_shares、housing_sublets_temporary、jobs、gigs、resumes、services、community、events。指定可能な値:
cars_truckscommunityelectronicseventsfor_salefurnituregigshousing_apartments_houseshousing_rooms_shareshousing_sublets_temporaryjobsresumesservicesCraigslist：カテゴリディレクトリとテキスト検索の関係 — Craigslistの公式ガイダンスでは、まず地域のカテゴリを選択し、その後テキストクエリで結果を絞り込むよう案内しています。このアクションのcategoryパラメータは上記で定義した中立的な値を使用し、プラットフォーム公式のカテゴリコードやその他のサイトフィルターを直接受け付けることはありません。 · 確認日 country任意- 国コードではなく、対象とする都市のサブドメインを選択します。newyork、sfbay、torontoなど、スキーマに記載された値を受け付けます。指定した場合、regionやlocationによるサブドメインの選択より優先されます。指定可能な値:
anchorageatlantaaustinbaltimorebostoncalgarycharlottechicagocincinnaticlevelandcolumbusdallasdenverdetroitedmontonhartfordhonoluluhoustonindianapoliskansascitylasvegaslosangelesmiamimilwaukeeminneapolismontrealnashvillenewhavennewyorkorlandoottawaphiladelphiaphoenixpittsburghportlandprovidenceraleighrichmondsacramentosalemsaltlakecitysanantoniosandiegoseattlesfbaystlouistampatorontovancouverwashingtondcCraigslist：地域の選択と都市サブサイトでの検索の違い — Craigslistでは地域の選択と検索クエリの処理が分かれており、公式には地図やZIPコードで絞り込むツールが用意されています。このアクションのcountry / regionパラメータは上記で定義した都市サブサイト形式のみを受け付け、郵便番号や半径による絞り込みには対応していません。 · 確認日 location任意- regionのフォールバック入力として機能し、regionを省略した場合にのみ評価されます。Craigslistの都市サブドメインに対応し、住所、郵便番号、地理座標には対応しません。
max_price任意- 選択した都市サブドメインとカテゴリにおける出品価格の上限を設定します。min_priceと組み合わせて使用します。通貨と支払い周期は各出品によって決まります。絞り込みは整数で行われ、小数は切り上げられます（145.98は146になります）。
min_price任意- 選択した都市サブドメインとカテゴリにおける出品価格の下限を設定します。APIリクエストの費用を表すものではなく、価格の意味はカテゴリによって異なります（中古品の販売価格と住宅の家賃など）。絞り込みは整数で行われ、小数は切り捨てられます（39.81は39になります）。
region任意- 都市サブドメインのスラッグを指定します（例：newyork、sfbay、toronto）。リストの値と完全に一致する値、またはnyc、la、dc、sanfranciscoなどの一般的なエイリアスを受け付けます。認識できない入力はnewyorkにフォールバックするため、入力が使われたと想定せず、返されたlocationを確認してください。
sort任意- 結果を新着順（newest）、価格の安い順（price_asc）、関連度順（relevance）で並べ替えます。省略した場合は新着順です。出品者の評価や取引量では並べ替えられません。指定可能な値:
newestprice_ascrelevance
Craigslist APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"craigslist","action":"search","params":{"keyword":"<keyword>"}}'
Craigslist APIに関する質問
Craigslist APIでは何を取得できますか？
platformをcraigslistに設定します。現在のカタログには検索が掲載されています。これらのアクション名はそれぞれ異なるCraigslistのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Craigslistのsearchリクエストを開始するには、どの入力を使用しますか？
Craigslistのクラシファイド広告を検索するキーワードを指定します（例：bicycle）。返される出品は選択したカテゴリによって決まるため、同じキーワードで販売、住宅、求人を検索できます。params内のkeywordとして送信してください。
Craigslistのsearchはどのフィールドを返しますか？
宣言されたスキーマにはtitle、text、price、currencyが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Craigslistのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。