WOLFRAM

Wolfram言語 ＆ システムドキュメントセンター

URLDownload[url]

指定されたURLのコンテンツをローカルの一時ファイルにダウンロードする．

URLDownload[{url1,url2,…}]

指定されたURLのコンテンツをローカルの一時ディレクトリにダウンロードする．

URLDownload[url,file]

指定のファイルをダウンロードする．

URLDownload[{url1,url2,…},dir]

指定のディレクトリにダウンロードする．

URLDownload[HTTPRequest[…],…]

指定のHTTPリクエストの結果をダウンロードする．

URLDownload[{req1,req2,…},…]

HTTPリクエストのリストの結果をダウンロードする．

URLDownload[req,loc,elem]

応答から要素 elem だけを返す．

URLDownload[req,loc,{elem1,elem2,…}]

要素 elemiの値の連想を返す．

詳細とオプション
Details and Options Details and Options
例題  
例  
スコープ  
一般化と拡張  
オプション  
CookieFunction  
FollowRedirects  
TimeConstraint  
VerifySecurityCertificates  
特性と関係  
考えられる問題  
関連項目
関連するガイド
履歴
引用書式

URLDownload

URLDownload[url]

指定されたURLのコンテンツをローカルの一時ファイルにダウンロードする．

URLDownload[{url1,url2,…}]

指定されたURLのコンテンツをローカルの一時ディレクトリにダウンロードする．

URLDownload[url,file]

指定のファイルをダウンロードする．

URLDownload[{url1,url2,…},dir]

指定のディレクトリにダウンロードする．

URLDownload[HTTPRequest[…],…]

指定のHTTPリクエストの結果をダウンロードする．

URLDownload[{req1,req2,…},…]

HTTPリクエストのリストの結果をダウンロードする．

URLDownload[req,loc,elem]

応答から要素 elem だけを返す．

URLDownload[req,loc,{elem1,elem2,…}]

要素 elemiの値の連想を返す．

詳細とオプション

  • URLDownload[url]は，ディレクトリ$TemporaryDirectoryにローカルの一時ファイルを作る．
  • URLDownload[{url1,url2,…}]は，ディレクトリ$TemporaryDirectoryにローカルの一時ファイルを作る．
  • URLDownload[url,…]は作成したFile[…]オブジェクトを返す．URLが見付からなかったりファイルが作れなかったりした場合はFailure[…]オブジェクトを返す．
  • URLDownload[{url1,url2,…},…]はFile[…]オブジェクトあるいはFailure[…]オブジェクトのリストを返す．
  • URLDownload[{url1,url2,…},…]では，作成されたファイルは受信したハンドラから生成された，あるいはURLパス urliの最終要素の名前を持つ．同じ名前のファイルがすでに存在する場合は，接尾辞"-n"が加えられる．
  • URLDownload[req,…]とURLDownload[{req1,req2,…},…]では，リクエストはHTTPRequest[…]オブジェクトまたはURLReadにおけるような成分とメタデータ要素を与える連想でよい．
  • URLDownloadは次のオプションを取る．
  • AuthenticationNone送信する認証情報
    CookieFunction Automatic受信した各クッキーに適用する関数
    FollowRedirects TrueHTTPリダイレクトを追跡するかどうか
    InteractiveTrueインタラクティブな認証ダイアログを許可するかどうか
    TimeConstraint Infinity応答を待つ時間
    VerifySecurityCertificates TrueSSLセキュリティ証明を検証するかどうか
  • TimeConstraint->t のときは，URLへの接続とそこからの読取りに最大 t 秒が許容される．
  • TimeConstraint-><|"Connecting"->tc,"Reading"->tr|>は，URLへの接続とそこからの読取りに別々の制限時間を指定する．
  • URLDownload[req,loc,elem]では，以下の要素を使うことができる．
  • "File"応答の本文を読むファイルオブジェクト
    "Headers"応答で受信したヘッダのリスト
    "Cookies"応答で受信したクッキーのリスト
    "ContentType"コンテンツタイプヘッダ
    "StatusCode"サーバが返した状態コード
    "StatusCodeDescription"状態コードのテキストによる説明
    {elem1,elem2,…}要素 elemiの連想
    Automatic記号Fileオブジェクト
    All全要素の連想

例題

すべて開く すべて閉じる

例  (5)

サーバから小さいファイルをダウンロードする：

Wolfram Language code: file = URLDownload["https://www.wolfram.com/favicon.ico"]

ファイルのコンテンツをインポートする：

Wolfram Language code: Import[file]

ファイルを削除する：

Wolfram Language code: DeleteFile[file]

複数のファイルをダウンロードする：

Wolfram Language code: files = URLDownload[{"https://www.wolfram.com", "https://www.wolfram.com/favicon.ico"}]

ファイルを削除する：

Wolfram Language code: DeleteFile[files]

ファイルをダウンロードし，これに名前を付ける：

Wolfram Language code: file = URLDownload["https://www.wolfram.com/favicon.ico", "favicon.ico"]

ファイルを削除する：

Wolfram Language code: DeleteFile[file]

ダウンロードした複数のファイルを入れるディレクトリを作る：

Wolfram Language code: directory = CreateDirectory[FileNameJoin[{$HomeDirectory, "Downloads", "tmp"}]];

このディレクトリに複数のファイルをダウンロードする：

Wolfram Language code: URLDownload[{"https://www.wolfram.com", "https://www.wolfram.com/favicon.ico"}, directory]

ディレクトリとファイルを削除する：

Wolfram Language code: DeleteDirectory[directory, DeleteContents -> True]

Webページをダウンロードしてステータスコードのみを返す：

Wolfram Language code: URLDownload["https://www.wolfram.com", Automatic, "StatusCode"]

スコープ  (4)

URLオブジェクトを使ってファイルをダウンロードする：

Wolfram Language code: file = URLDownload[URL["https://www.wolfram.com/favicon.ico"]]
Wolfram Language code: DeleteFile[file]

HTTPRequestオブジェクトを使ってファイルをダウンロードする：

Wolfram Language code: file = URLDownload[HTTPRequest["https://www.wolfram.com/favicon.ico"]]

ファイルを削除する：

Wolfram Language code: DeleteFile[file]

HTTPRequestオブジェクトを使って複数のファイルをダウンロードする：

Wolfram Language code: files = URLDownload[{HTTPRequest["https://www.wolfram.com", <|"Method" -> "GET"|>], HTTPRequest["https://www.wolfram.com/favicon.ico", <|"Method" -> "GET"|>]}]

このファイルを削除する：

Wolfram Language code: DeleteFile[files]

Webページをダウンロードしてヘッダとファイルの場所を返す：

Wolfram Language code: URLDownload["https://www.wolfram.com", Automatic, {"Headers", "File"}]

一般化と拡張  (1)

HTTPRequestオブジェクトは，Webのリクエストを行う際の最も一般的で柔軟な方法である：

Wolfram Language code: URLDownload[HTTPRequest["https://en.wikipedia.org/w/api.php", <|"Query" -> {"format" -> "json", "action" -> "query", "titles" -> "Main Page", "prop" -> "revisions", "rvprop" -> "content"}|>]]

オプション  (4)

CookieFunction  (1)

HTTP応答を受信したときに受信した各クッキーに関数を適用する：

Wolfram Language code: ClearCookies["www.wolfram.com"]; URLDownload["https://www.wolfram.com/", CookieFunction -> Print]

FollowRedirects  (1)

URLを受信する際に，HTTPリダイレクトに従うかどうかを指定する：

Wolfram Language code: url = URLShorten["https://wolfram.com"]
Wolfram Language code: URLDownload[url, Automatic, "StatusCode", FollowRedirects -> False]
Wolfram Language code: URLDownload[url, Automatic, "StatusCode", FollowRedirects -> True]

TimeConstraint  (1)

サーバからのデータのダウンロードに割り当てられた時間を秒単位で指定する：

Wolfram Language code: URLDownload["https://www.wolframcloud.com/obj/9f6327e7-82cf-45ba-9bf0-6eade0d40c4c", TimeConstraint -> 1]

VerifySecurityCertificates  (1)

サーバが使ったSSL証明が有効かどうか確かめる：

Wolfram Language code: URLDownload["https://wolfram.com", VerifySecurityCertificates -> True]

特性と関係  (2)

FileとCloudObjectは完全にサポートされている：

Wolfram Language code: URLDownload[URL["https://httpbin.org/uuid"]]

ImportあるいはURLExecuteを使ってHTTPRequestを行う：

Wolfram Language code: api = CloudDeploy[APIFunction[{"text" -> "String" -> "Hello"}, ImageResize[Graphics[{Circle[], Text[Style[#text, 40], {0, 0}]}], 100]&, "PNG"]]
Wolfram Language code: Import[HTTPRequest[api]]
Wolfram Language code: URLExecute[HTTPRequest[api], {"text" -> "Ciao"}]

考えられる問題  (1)

URLDownloadはホストが応答を返せないときはFailureを返す：

Wolfram Language code: URLDownload["https://not-a-domain.no/"]

URLDownloadは，たとえ"StatusCode"がクライアントまたはサーバのエラーを示しても，常にサーバの応答をダウンロードする：

Wolfram Language code: URLDownload["https://httpbin.org/status/500", Automatic, {"File", "StatusCode"}]
Wolfram Research (2016), URLDownload, Wolfram言語関数， https://reference.wolfram.com/language/ref/URLDownload.html.

テキスト

Wolfram Research (2016), URLDownload, Wolfram言語関数， https://reference.wolfram.com/language/ref/URLDownload.html.

CMS

Wolfram Language. 2016. "URLDownload." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/URLDownload.html.

APA

Wolfram Language. (2016). URLDownload. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/URLDownload.html

BibTeX

@misc{reference.wolfram_2026_urldownload, author="Wolfram Research", title="{URLDownload}", year="2016", howpublished="\url{https://reference.wolfram.com/language/ref/URLDownload.html}", note=[Accessed: 02-November-2026]}

BibLaTeX

@online{reference.wolfram_2026_urldownload, organization={Wolfram Research}, title={URLDownload}, year={2016}, url={https://reference.wolfram.com/language/ref/URLDownload.html}, note=[Accessed: 02-November-2026]}