Introduction

The Lateral API

Pre-populated datasets

Tools

Sign-up for an API Key

arXiv Recommender

Authentication

Every request must be authenticated with your subscription key. This must be sent as an HTTP header:

Subscription-Key: YOUR_KEY_HERE

Requests

All requests must be sent with a JSON body and with a JSON content type header:

Content-Type: application/json

404 Errors

When a request to a path not in the API is made, you will get the following error message:

{
  "message": "Not Found"
}

API Specification

  • Go
  • Java
  • Node.js
  • PHP
  • Python
  • Ruby
  • Shell

arXiv

Recommend by text/documents/similar-to-text?fields=meta

POST/documents/similar-to-text?fields=metaRecommend by text
Code Sample

Returns recommendations of documents from the corpus that are similar to the given text.

Parameters
Name Example Description
text(string, required) The text to get recommendations for
Response200

The recommendations, truncated

Response (200)
[
  {
    "id": "00000372672010380c6ba628a298e7de",
    "meta": {
      "id": "00000372672010380c6ba628a298e7de",
      "url": "http://arxiv.org/abs/1102.5675",
      "date": "2011-02-28",
      "title": "Rotational spectroscopy, dipole moment and $^{14}$N nuclear hyperfine   structure of $iso$-propyl cyanide",
      "authors": [
        "Müller, Holger S. P.",
        "Coutens, Audrey",
        ...
      ],
      "summary": "Rotational transitions of $iso$-propyl cyanide, (CH$_3$)$_2$CHCN, also known as $iso$-butyronitrile, were recorded using long-path absorption spectroscopy in selected regions between 37 and 600 GHz. Further measurements were carried out between 6 and 20 GHz employing Fourier transform microwave (FTMW) spectroscopy on a pulsed molecular supersonic jet. The observed transitions reach $J$ and $K_ ...",
      "subjects": [
        "Astrophysics - Instrumentation and Methods for Astrophysics",
        "Astrophysics - Astrophysics of Galaxies",
        "Physics - Chemical Physics"
      ]
    },
    "similarity": 1
  },
  {
    "id": "aa4be58cb8d41b5f9b6aaad4638f9f52",
    "meta": {
      "id": "aa4be58cb8d41b5f9b6aaad4638f9f52",
      "url": "http://arxiv.org/abs/1611.01952",
      "date": "2016-11-07",
      "title": "The high resolution spectrum of methyltrioxorhenium reinvestigated with   new infrared and millimeter-wave measurements",
      "authors": [
        "Asselin, Pierre",
        "Berger, Yann",
        ...
      ],
      "summary": "Following our first paper about high resolution spectroscopy of methyltrioxorhenium (MTO) [Stoeffler et al. PCCP, 13, 854, (2011)], the present study reports a deeper investigation of the ground state, and Re=O antisymmetric (nu_as) and symmetric (nu_s) stretching excited states of both CH3(187Re)O3 and CH3(185Re)O3 isotopologues, thanks to new devices implemented within our consortium. We car ...",
      "subjects": [
        "Physics - Atomic Physics",
        "Physics - Chemical Physics"
      ]
    },
    "similarity": 0.9115979671
  },
  ...
]

Recommend by ID/documents/{id}/similar?fields=meta

GET/documents/{id}/similar?fields=metaRecommend by ID
Code Sample

Returns recommendations of documents from the corpus that are similar to the given id.

Response200

The recommendations, truncated

Response (200)
[
  {
    "id": "00000372672010380c6ba628a298e7de",
    "meta": {
      "id": "00000372672010380c6ba628a298e7de",
      "url": "http://arxiv.org/abs/1102.5675",
      "date": "2011-02-28",
      "title": "Rotational spectroscopy, dipole moment and $^{14}$N nuclear hyperfine   structure of $iso$-propyl cyanide",
      "authors": [
        "Müller, Holger S. P.",
        "Coutens, Audrey",
        ...
      ],
      "summary": "Rotational transitions of $iso$-propyl cyanide, (CH$_3$)$_2$CHCN, also known as $iso$-butyronitrile, were recorded using long-path absorption spectroscopy in selected regions between 37 and 600 GHz. Further measurements were carried out between 6 and 20 GHz employing Fourier transform microwave (FTMW) spectroscopy on a pulsed molecular supersonic jet. The observed transitions reach $J$ and $K_ ...",
      "subjects": [
        "Astrophysics - Instrumentation and Methods for Astrophysics",
        "Astrophysics - Astrophysics of Galaxies",
        "Physics - Chemical Physics"
      ]
    },
    "similarity": 1
  },
  {
    "id": "aa4be58cb8d41b5f9b6aaad4638f9f52",
    "meta": {
      "id": "aa4be58cb8d41b5f9b6aaad4638f9f52",
      "url": "http://arxiv.org/abs/1611.01952",
      "date": "2016-11-07",
      "title": "The high resolution spectrum of methyltrioxorhenium reinvestigated with   new infrared and millimeter-wave measurements",
      "authors": [
        "Asselin, Pierre",
        "Berger, Yann",
        ...
      ],
      "summary": "Following our first paper about high resolution spectroscopy of methyltrioxorhenium (MTO) [Stoeffler et al. PCCP, 13, 854, (2011)], the present study reports a deeper investigation of the ground state, and Re=O antisymmetric (nu_as) and symmetric (nu_s) stretching excited states of both CH3(187Re)O3 and CH3(185Re)O3 isotopologues, thanks to new devices implemented within our consortium. We car ...",
      "subjects": [
        "Physics - Atomic Physics",
        "Physics - Chemical Physics"
      ]
    },
    "similarity": 0.9115979671
  },
  ...
]
Response404

Returned if the id is not found.

Response (404)
{ "message":"Couldn't find Document" }