{
  "_id": "69e49296c5259ad4cd986336",
  "Package": "comtradr",
  "Title": "Interface with the United Nations Comtrade API",
  "Version": "1.0.5",
  "Maintainer": "Paul Bochtler <paulbochtler.gh@gmail.com>",
  "Authors@R": "c(\nperson(\"Paul\", \"Bochtler\",\nemail = \"paulbochtler.gh@gmail.com\",\nrole = c(\"aut\", \"cre\",\"cph\"),\ncomment = c(ORCID = \"0000-0002-9146-6185\")),\nperson(\"Harriet\", \"Goers\",\nemail = \"hgoers@umd.edu\",\nrole = c(\"aut\")),\nperson(\"Chris\", \"Muir\",\nemail = \"chrismuirRVA@gmail.com\",\nrole = c(\"aut\")),\nperson(\"Alicia\", \"Schep\",\nrole = \"rev\",\ncomment = c(ORCID = \"0000-0002-3915-0618\",\n\"Alicia reviewed the package for rOpenSci,\nsee https://github.com/ropensci/onboarding/issues/141\")),\nperson(\"Rafael\", \"Hellwig\",\nrole = \"rev\",\ncomment = c(ORCID = \"0000-0002-3092-3493\",\n\"Rafael reviewed the package for rOpenSci,\nsee https://github.com/ropensci/onboarding/issues/141\")),\nperson(\"Ernest\", \"Guevarra\",\nrole = \"rev\",\ncomment = c(ORCID = \"0000-0002-4887-4415\",\n\"Ernest reviewed the package for rOpenSci,\nsee https://github.com/ropensci/software-review/issues/613\")),\nperson(\"Nicholas\", \"Potter\",\nrole = \"rev\",\ncomment = c(ORCID = \"0000-0002-3410-3732\",\n\"Nicholas reviewed the package for rOpenSci,\nsee https://github.com/ropensci/software-review/issues/613\")),\nperson(\"Juergen\", \"Amann\", role=c(\"ctb\")))",
  "Description": "Interface with and extract data from the United Nations\n'Comtrade' API <https://comtradeplus.un.org/>. 'Comtrade'\nprovides country level shipping data for a variety of\ncommodities, these functions allow for easy API query and data\nreturned as a tidy data frame.",
  "License": "GPL-3",
  "Encoding": "UTF-8",
  "LazyData": "true",
  "RoxygenNote": "7.3.3",
  "URL": "https://docs.ropensci.org/comtradr/,\nhttps://github.com/ropensci/comtradr",
  "BugReports": "https://github.com/ropensci/comtradr/issues",
  "NeedsCompilation": "no",
  "VignetteBuilder": "knitr",
  "Roxygen": "list(markdown = TRUE)",
  "Config/testthat/edition": "3",
  "Language": "en-US",
  "Config/pak/sysreqs": "cmake make libicu-dev libuv1-dev libssl-dev\nlibx11-dev",
  "Repository": "https://ropensci.r-universe.dev",
  "Date/Publication": "2025-12-14 16:52:05 UTC",
  "RemoteUrl": "https://github.com/ropensci/comtradr",
  "RemoteRef": "main",
  "RemoteSha": "3d5b52d6a3e10093b24b7883fb62f3d49b1ba4c8",
  "Packaged": {
    "Date": "2026-04-19 08:26:53 UTC",
    "User": "root"
  },
  "Author": "Paul Bochtler [aut, cre, cph] (ORCID:\n<https://orcid.org/0000-0002-9146-6185>),\nHarriet Goers [aut],\nChris Muir [aut],\nAlicia Schep [rev] (ORCID: <https://orcid.org/0000-0002-3915-0618>,\nAlicia reviewed the package for rOpenSci, see\nhttps://github.com/ropensci/onboarding/issues/141),\nRafael Hellwig [rev] (ORCID: <https://orcid.org/0000-0002-3092-3493>,\nRafael reviewed the package for rOpenSci, see\nhttps://github.com/ropensci/onboarding/issues/141),\nErnest Guevarra [rev] (ORCID: <https://orcid.org/0000-0002-4887-4415>,\nErnest reviewed the package for rOpenSci, see\nhttps://github.com/ropensci/software-review/issues/613),\nNicholas Potter [rev] (ORCID: <https://orcid.org/0000-0002-3410-3732>,\nNicholas reviewed the package for rOpenSci, see\nhttps://github.com/ropensci/software-review/issues/613),\nJuergen Amann [ctb]",
  "MD5sum": "71f7f8542a73a18b61ce7e0d321b5af3",
  "_user": "ropensci",
  "_type": "src",
  "_file": "comtradr_1.0.5.tar.gz",
  "_fileid": "20df75b4353a939bcc1fcd9756aa57abd3718c2ee286415c705750963069bf95",
  "_filesize": 3785282,
  "_sha256": "20df75b4353a939bcc1fcd9756aa57abd3718c2ee286415c705750963069bf95",
  "_created": "2026-04-19T08:26:53.000Z",
  "_published": "2026-04-19T08:30:14.534Z",
  "_distro": "noble",
  "_jobs": [
    {
      "job": 72001807339,
      "time": 158,
      "config": "linux-devel-x86_64",
      "r": "4.6.0",
      "check": "OK",
      "artifact": "6516878887"
    },
    {
      "job": 72001807350,
      "time": 144,
      "config": "linux-release-x86_64",
      "r": "4.5.3",
      "check": "OK",
      "artifact": "6516877604"
    },
    {
      "job": 72001807355,
      "time": 138,
      "config": "macos-oldrel-arm64",
      "r": "4.5.3",
      "check": "OK",
      "artifact": "6516876931"
    },
    {
      "job": 72001807353,
      "time": 140,
      "config": "macos-release-arm64",
      "r": "4.6.0",
      "check": "OK",
      "artifact": "6516876992"
    },
    {
      "job": 72001648384,
      "time": 208,
      "config": "pkgdown",
      "r": "4.5.2",
      "check": "OK",
      "artifact": "6516863860"
    },
    {
      "job": 72001648383,
      "time": 203,
      "config": "source",
      "r": "4.5.3",
      "check": "OK",
      "artifact": "6516863526"
    },
    {
      "job": 72001807334,
      "time": 117,
      "config": "wasm-release",
      "r": "4.5.1",
      "check": "OK",
      "artifact": "6516874857"
    },
    {
      "job": 72001807340,
      "time": 137,
      "config": "windows-devel",
      "r": "4.7.0",
      "check": "OK",
      "artifact": "6516876767"
    },
    {
      "job": 72001807336,
      "time": 120,
      "config": "windows-oldrel",
      "r": "4.5.3",
      "check": "OK",
      "artifact": "6516875074"
    },
    {
      "job": 72001807352,
      "time": 138,
      "config": "windows-release",
      "r": "4.6.0",
      "check": "OK",
      "artifact": "6516876985"
    }
  ],
  "_buildurl": "https://github.com/r-universe/ropensci/actions/runs/24624743833",
  "_status": "success",
  "_host": "GitHub-Actions",
  "_upstream": "https://github.com/ropensci/comtradr",
  "_commit": {
    "id": "3d5b52d6a3e10093b24b7883fb62f3d49b1ba4c8",
    "author": "paul bochtler <65470117+datapumpernickel@users.noreply.github.com>",
    "committer": "paul bochtler <65470117+datapumpernickel@users.noreply.github.com>",
    "message": "adjust cran comments\n",
    "time": 1765731125
  },
  "_maintainer": {
    "name": "Paul Bochtler",
    "email": "paulbochtler.gh@gmail.com",
    "orcid": "0000-0002-9146-6185"
  },
  "_registered": true,
  "_dependencies": [
    {
      "package": "R",
      "version": ">= 4.1.0",
      "role": "Depends"
    },
    {
      "package": "lifecycle",
      "role": "Imports"
    },
    {
      "package": "fs",
      "role": "Imports"
    },
    {
      "package": "readr",
      "role": "Imports"
    },
    {
      "package": "askpass",
      "role": "Imports"
    },
    {
      "package": "cli",
      "role": "Imports"
    },
    {
      "package": "httr2",
      "role": "Imports"
    },
    {
      "package": "rlang",
      "role": "Imports"
    },
    {
      "package": "stringr",
      "role": "Imports"
    },
    {
      "package": "poorman",
      "role": "Imports"
    },
    {
      "package": "lubridate",
      "role": "Imports"
    },
    {
      "package": "purrr",
      "role": "Imports"
    },
    {
      "package": "tools",
      "role": "Imports"
    },
    {
      "package": "rappdirs",
      "role": "Imports"
    },
    {
      "package": "memoise",
      "role": "Imports"
    },
    {
      "package": "cachem",
      "role": "Imports"
    },
    {
      "package": "covr",
      "role": "Suggests"
    },
    {
      "package": "dplyr",
      "role": "Suggests"
    },
    {
      "package": "ggplot2",
      "role": "Suggests"
    },
    {
      "package": "httptest2",
      "role": "Suggests"
    },
    {
      "package": "knitr",
      "role": "Suggests"
    },
    {
      "package": "rmarkdown",
      "role": "Suggests"
    },
    {
      "package": "spelling",
      "role": "Suggests"
    },
    {
      "package": "testthat",
      "version": ">= 3.0.0",
      "role": "Suggests"
    },
    {
      "package": "callr",
      "role": "Suggests"
    }
  ],
  "_owner": "ropensci",
  "_selfowned": true,
  "_usedby": 0,
  "_updates": [
    {
      "week": "2025-31",
      "n": 5
    },
    {
      "week": "2025-39",
      "n": 1
    },
    {
      "week": "2025-49",
      "n": 3
    },
    {
      "week": "2025-50",
      "n": 4
    }
  ],
  "_tags": [
    {
      "name": "v1.0.4",
      "date": "2025-09-27"
    },
    {
      "name": "v1.0.5",
      "date": "2025-12-14"
    }
  ],
  "_topics": [
    "api",
    "comtrade",
    "peer-reviewed",
    "supply-chain"
  ],
  "_stars": 81,
  "_contributors": [
    {
      "user": "datapumpernickel",
      "count": 331,
      "uuid": 65470117
    },
    {
      "user": "chrismuir",
      "count": 264,
      "uuid": 13386824
    },
    {
      "user": "hgoers",
      "count": 44,
      "uuid": 52492407
    },
    {
      "user": "amannj",
      "count": 5,
      "uuid": 16940930
    },
    {
      "user": "sckott",
      "count": 2,
      "uuid": 577668
    },
    {
      "user": "luifrancgom",
      "count": 1,
      "uuid": 50002526
    },
    {
      "user": "pachadotdev",
      "count": 1,
      "uuid": 10091065
    }
  ],
  "_userbio": {
    "uuid": 1200269,
    "type": "organization",
    "name": "rOpenSci",
    "description": "Tools and R Packages for Open Science"
  },
  "_downloads": {
    "count": 1075,
    "source": "https://cranlogs.r-pkg.org/downloads/total/last-month/comtradr"
  },
  "_mentions": 1,
  "_devurl": "https://github.com/ropensci/comtradr",
  "_pkgdown": "https://docs.ropensci.org/comtradr/",
  "_searchresults": 118,
  "_metadata": {
    "review": {
      "id": 613,
      "status": "reviewed",
      "version": "0.4.0.0",
      "organization": "rOpenSci Software Review",
      "url": "https://github.com/ropensci/software-review/issues/613"
    },
    "ropensci_category": "data-access"
  },
  "_rbuild": "4.5.3",
  "_assets": [
    "extra/citation.cff",
    "extra/citation.html",
    "extra/citation.json",
    "extra/citation.txt",
    "extra/comtradr.html",
    "extra/contents.json",
    "extra/NEWS.html",
    "extra/NEWS.txt",
    "extra/readme.html",
    "extra/readme.md",
    "manual.pdf"
  ],
  "_homeurl": "https://github.com/ropensci/comtradr",
  "_realowner": "ropensci",
  "_cranurl": true,
  "_releases": [
    {
      "version": "0.0.1",
      "date": "2017-04-05"
    },
    {
      "version": "0.0.2",
      "date": "2017-07-03"
    },
    {
      "version": "0.1.0",
      "date": "2017-10-24"
    },
    {
      "version": "0.2.1",
      "date": "2018-05-05"
    },
    {
      "version": "0.2.2",
      "date": "2018-10-05"
    },
    {
      "version": "0.3.0",
      "date": "2022-04-20"
    },
    {
      "version": "0.4.0.0",
      "date": "2024-02-06"
    },
    {
      "version": "1.0.0",
      "date": "2024-05-14"
    },
    {
      "version": "1.0.1",
      "date": "2024-05-24"
    },
    {
      "version": "1.0.2",
      "date": "2024-09-20"
    },
    {
      "version": "1.0.3",
      "date": "2024-11-15"
    },
    {
      "version": "1.0.4",
      "date": "2025-09-27"
    },
    {
      "version": "1.0.5",
      "date": "2025-12-15"
    }
  ],
  "_exports": [
    "ct_commodity_db_type",
    "ct_commodity_lookup",
    "ct_country_lookup",
    "ct_get_bulk",
    "ct_get_data",
    "ct_get_ref_table",
    "ct_get_remaining_hourly_queries",
    "ct_get_reset_time",
    "ct_migrate_cache",
    "ct_register_token",
    "ct_search",
    "ct_update_databases",
    "ct_use_pretty_cols",
    "get_primary_comtrade_key",
    "set_primary_comtrade_key"
  ],
  "_datasets": [
    {
      "name": "country_codes",
      "title": "Country codes",
      "object": "country_codes",
      "class": [
        "data.frame"
      ],
      "fields": [
        "id",
        "country",
        "iso_3",
        "iso_2",
        "note",
        "entry_year",
        "exit_year",
        "group",
        "last_modified",
        "reporter",
        "partner"
      ],
      "rows": 313,
      "table": true,
      "tojson": true
    },
    {
      "name": "ct_pretty_cols",
      "title": "ct_pretty_cols",
      "object": "ct_pretty_cols",
      "class": [
        "data.frame"
      ],
      "fields": [
        "to",
        "from"
      ],
      "rows": 56,
      "table": true,
      "tojson": true
    }
  ],
  "_help": [
    {
      "page": "country_codes",
      "title": "Country codes",
      "topics": [
        "country_codes"
      ]
    },
    {
      "page": "ct_commodity_db_type",
      "title": "ct_commodity_db_type",
      "topics": [
        "ct_commodity_db_type"
      ]
    },
    {
      "page": "ct_commodity_lookup",
      "title": "UN Comtrade commodities database query",
      "topics": [
        "ct_commodity_lookup"
      ]
    },
    {
      "page": "ct_country_lookup",
      "title": "ct_country_lookup",
      "topics": [
        "ct_country_lookup"
      ]
    },
    {
      "page": "ct_get_bulk",
      "title": "Get trade data from the UN Comtrade API",
      "topics": [
        "ct_get_bulk"
      ]
    },
    {
      "page": "ct_get_data",
      "title": "Get trade data from the UN Comtrade API",
      "topics": [
        "ct_get_data"
      ]
    },
    {
      "page": "ct_get_ref_table",
      "title": "Get reference table from package data",
      "topics": [
        "ct_get_ref_table"
      ]
    },
    {
      "page": "ct_get_remaining_hourly_queries",
      "title": "ct_get_remaining_hourly_queries",
      "topics": [
        "ct_get_remaining_hourly_queries"
      ]
    },
    {
      "page": "ct_get_reset_time",
      "title": "ct_get_reset_time",
      "topics": [
        "ct_get_reset_time"
      ]
    },
    {
      "page": "ct_migrate_cache",
      "title": "Migrate cache to new location",
      "topics": [
        "ct_migrate_cache"
      ]
    },
    {
      "page": "ct_pretty_cols",
      "title": "ct_pretty_cols",
      "topics": [
        "ct_pretty_cols"
      ]
    },
    {
      "page": "ct_register_token",
      "title": "ct_register_token",
      "topics": [
        "ct_register_token"
      ]
    },
    {
      "page": "ct_search",
      "title": "ct_search",
      "topics": [
        "ct_search"
      ]
    },
    {
      "page": "ct_update_databases",
      "title": "ct_update_databases",
      "topics": [
        "ct_update_databases"
      ]
    },
    {
      "page": "ct_use_pretty_cols",
      "title": "ct_use_pretty_cols",
      "topics": [
        "ct_use_pretty_cols"
      ]
    },
    {
      "page": "get_primary_comtrade_key",
      "title": "get_primary_comtrade_key",
      "topics": [
        "get_primary_comtrade_key"
      ]
    },
    {
      "page": "set_primary_comtrade_key",
      "title": "Set your primary Comtrade API key in the environment variable",
      "topics": [
        "set_primary_comtrade_key"
      ]
    }
  ],
  "_pkglogo": "https://github.com/ropensci/comtradr/raw/main/man/figures/logo.png",
  "_readme": "https://github.com/ropensci/comtradr/raw/main/README.md",
  "_rundeps": [
    "askpass",
    "bit",
    "bit64",
    "cachem",
    "cli",
    "clipr",
    "cpp11",
    "crayon",
    "curl",
    "fastmap",
    "fs",
    "generics",
    "glue",
    "hms",
    "httr2",
    "lifecycle",
    "lubridate",
    "magrittr",
    "memoise",
    "openssl",
    "pillar",
    "pkgconfig",
    "poorman",
    "prettyunits",
    "progress",
    "purrr",
    "R6",
    "rappdirs",
    "readr",
    "rlang",
    "stringi",
    "stringr",
    "sys",
    "tibble",
    "tidyselect",
    "timechange",
    "tzdb",
    "utf8",
    "vctrs",
    "vroom",
    "withr"
  ],
  "_vignettes": [
    {
      "source": "bulk_files.Rmd",
      "filename": "bulk_files.html",
      "title": "Querying bulk files from the API",
      "engine": "knitr::rmarkdown",
      "headings": [
        "Why use bulk files? 📦📦📦",
        "Accounting for HS Code changes 🏗️👷",
        "Getting started with bulk files 🏃",
        "Formatting bulk files 📝"
      ],
      "created": "2024-05-13 10:05:11",
      "modified": "2024-05-13 10:05:11",
      "commits": 1
    },
    {
      "source": "caching.Rmd",
      "filename": "caching.html",
      "title": "Caching requests from the UN Comtrade API",
      "engine": "knitr::rmarkdown",
      "headings": [
        "Caching requests from the UN Comtrade API",
        "The basics of caching 💽",
        "Careful with outdated data! ⚠️"
      ],
      "created": "2024-02-04 07:55:40",
      "modified": "2024-05-23 12:02:37",
      "commits": 5
    },
    {
      "source": "comtradr.Rmd",
      "filename": "comtradr.html",
      "title": "comtradr",
      "engine": "knitr::rmarkdown",
      "headings": [
        "Data availability",
        "Package information",
        "Install and load comtradr",
        "Authentication 🔐",
        "Storing the API key",
        "Making API calls",
        "API search metadata",
        "More on the lookup functions",
        "API rate limits",
        "Package Data",
        "Visualize",
        "Handling large amounts of Parameters",
        "commodity_code",
        "flow_direction",
        "reporter and partner",
        "mode_of_transport, partner_2, and customs_code",
        "Example Usage"
      ],
      "created": "2023-06-27 20:57:41",
      "modified": "2025-07-31 14:41:40",
      "commits": 7
    },
    {
      "source": "large_data.Rmd",
      "filename": "large_data.html",
      "title": "Querying large amounts of data",
      "engine": "knitr::rmarkdown",
      "headings": [
        "The limits",
        "The example - Imports of the EU",
        "1. What are the commodity codes?",
        "2. Which are the countries?",
        "Getting the data",
        "EU imports from all countries",
        "Data cleaning",
        "Caveat on trade \"dependencies\""
      ],
      "created": "2023-12-22 19:07:13",
      "modified": "2024-05-13 10:05:11",
      "commits": 4
    },
    {
      "source": "transition.Rmd",
      "filename": "transition.html",
      "title": "Transition from old comtradr",
      "engine": "knitr::rmarkdown",
      "headings": [
        "Transitioning from the old API to the new API 🔄",
        "The basics 📊",
        "The time parameter",
        "Country Names 🌍",
        "Previously",
        "Now",
        "Searching for commodity codes 🚢📦",
        "Previously == Now",
        "API search metadata 📑",
        "Package Data 📦",
        "\"Polished\" Column Headers 🎨"
      ],
      "created": "2023-12-22 19:07:13",
      "modified": "2023-12-23 17:00:18",
      "commits": 2
    }
  ],
  "_score": 8.789926740820043,
  "_indexed": true,
  "_nocasepkg": "comtradr",
  "_universes": [
    "ropensci"
  ],
  "_binaries": [
    {
      "r": "4.6.0",
      "os": "linux",
      "version": "1.0.5",
      "date": "2026-04-19T08:29:19.000Z",
      "distro": "noble",
      "commit": "3d5b52d6a3e10093b24b7883fb62f3d49b1ba4c8",
      "fileid": "742c61ebb13e166708d3888c50c61c9b043b0d605ebe68159b5b2f05269bd99c",
      "status": "success",
      "check": "OK",
      "buildurl": "https://github.com/r-universe/ropensci/actions/runs/24624743833"
    },
    {
      "r": "4.5.3",
      "os": "mac",
      "version": "1.0.5",
      "date": "2026-04-19T08:28:37.000Z",
      "commit": "3d5b52d6a3e10093b24b7883fb62f3d49b1ba4c8",
      "fileid": "d9a3c1ce6682ac3eb09e7a4c1d975878fefadcfab7a6dae3062db67749a8c16d",
      "status": "success",
      "check": "OK",
      "buildurl": "https://github.com/r-universe/ropensci/actions/runs/24624743833"
    },
    {
      "r": "4.6.0",
      "os": "mac",
      "version": "1.0.5",
      "date": "2026-04-19T08:28:52.000Z",
      "commit": "3d5b52d6a3e10093b24b7883fb62f3d49b1ba4c8",
      "fileid": "8b6529b3133ca1e692f805983a9a512117569ed53ead805257ab0ee7aabd23eb",
      "status": "success",
      "check": "OK",
      "buildurl": "https://github.com/r-universe/ropensci/actions/runs/24624743833"
    },
    {
      "r": "4.5.1",
      "os": "wasm",
      "version": "1.0.5",
      "date": "2026-04-19T08:29:09.000Z",
      "commit": "3d5b52d6a3e10093b24b7883fb62f3d49b1ba4c8",
      "fileid": "27e3ed13b32715906f2723fb3d01ba07ed6d25955b8626f25ab3358dcc64ecd3",
      "status": "success",
      "buildurl": "https://github.com/r-universe/ropensci/actions/runs/24624743833"
    },
    {
      "r": "4.7.0",
      "os": "win",
      "version": "1.0.5",
      "date": "2026-04-19T08:29:00.000Z",
      "commit": "3d5b52d6a3e10093b24b7883fb62f3d49b1ba4c8",
      "fileid": "d96bae4babe6bd8f2743755f2fdbadeb2bea2e88519e9fe4083fb3a5f3688c8a",
      "status": "success",
      "check": "OK",
      "buildurl": "https://github.com/r-universe/ropensci/actions/runs/24624743833"
    },
    {
      "r": "4.5.3",
      "os": "win",
      "version": "1.0.5",
      "date": "2026-04-19T08:28:42.000Z",
      "commit": "3d5b52d6a3e10093b24b7883fb62f3d49b1ba4c8",
      "fileid": "24a2a76ec55f913111cde85660ae8919c5b81f7948479035807acdc7fef4d4c8",
      "status": "success",
      "check": "OK",
      "buildurl": "https://github.com/r-universe/ropensci/actions/runs/24624743833"
    },
    {
      "r": "4.6.0",
      "os": "win",
      "version": "1.0.5",
      "date": "2026-04-19T08:28:43.000Z",
      "commit": "3d5b52d6a3e10093b24b7883fb62f3d49b1ba4c8",
      "fileid": "d7daae88d442f6efd1af95a77152755cd8464530a98ec032d61fdc4606df4786",
      "status": "success",
      "check": "OK",
      "buildurl": "https://github.com/r-universe/ropensci/actions/runs/24624743833"
    }
  ]
}