---
title: "Scholarly search results"
method: POST
path: "/v1/scholar"
tags: ["API"]
---

# Scholarly search results

`POST /v1/scholar`

## Request

- Base URL: `https://api.fastaf.co`
- URL: `https://api.fastaf.co/v1/scholar`
- Auth: HTTP bearer

## Request body

- union
  - object
    - `html` boolean: FastAF html parameter.
    - `query` string, required: At least one of query, cites, and cluster is required; cluster is exclusive.
    - `language` string: FastAF language parameter.
    - `lr` string: FastAF lr parameter.
    - `cites` string: At least one of query, cites, and cluster is required; cluster is exclusive.
    - `as_ylo` string: FastAF as_ylo parameter.
    - `as_yhi` string: FastAF as_yhi parameter.
    - `scisbd` string: FastAF scisbd parameter.
    - `cluster` string: At least one of query, cites, and cluster is required; cluster is exclusive.
    - `as_sdt` string: FastAF as_sdt parameter.
    - `safe` string: FastAF safe parameter.
    - `filter` string: FastAF filter parameter.
    - `as_vis` string: FastAF as_vis parameter.
    - `as_rr` string: FastAF as_rr parameter.
    - `page` integer: FastAF page parameter.
    - `results` integer: FastAF results parameter.
  - object
    - `html` boolean: FastAF html parameter.
    - `query` string: At least one of query, cites, and cluster is required; cluster is exclusive.
    - `language` string: FastAF language parameter.
    - `lr` string: FastAF lr parameter.
    - `cites` string, required: At least one of query, cites, and cluster is required; cluster is exclusive.
    - `as_ylo` string: FastAF as_ylo parameter.
    - `as_yhi` string: FastAF as_yhi parameter.
    - `scisbd` string: FastAF scisbd parameter.
    - `cluster` string: At least one of query, cites, and cluster is required; cluster is exclusive.
    - `as_sdt` string: FastAF as_sdt parameter.
    - `safe` string: FastAF safe parameter.
    - `filter` string: FastAF filter parameter.
    - `as_vis` string: FastAF as_vis parameter.
    - `as_rr` string: FastAF as_rr parameter.
    - `page` integer: FastAF page parameter.
    - `results` integer: FastAF results parameter.
  - object
    - `html` boolean: FastAF html parameter.
    - `query` string: At least one of query, cites, and cluster is required; cluster is exclusive.
    - `language` string: FastAF language parameter.
    - `lr` string: FastAF lr parameter.
    - `cites` string: At least one of query, cites, and cluster is required; cluster is exclusive.
    - `as_ylo` string: FastAF as_ylo parameter.
    - `as_yhi` string: FastAF as_yhi parameter.
    - `scisbd` string: FastAF scisbd parameter.
    - `cluster` string, required: At least one of query, cites, and cluster is required; cluster is exclusive.
    - `as_sdt` string: FastAF as_sdt parameter.
    - `safe` string: FastAF safe parameter.
    - `filter` string: FastAF filter parameter.
    - `as_vis` string: FastAF as_vis parameter.
    - `as_rr` string: FastAF as_rr parameter.
    - `page` integer: FastAF page parameter.
    - `results` integer: FastAF results parameter.

## Response `200`

Provider response.

## Other responses

- `400`: Invalid request or parameters.
- `401`: A valid bearer API key is required.
- `402`: The account has insufficient credits.
- `403`: The account is suspended.
- `429`: A rate or concurrency limit was reached.
- `502`: The upstream request failed.
- `503`: The service is temporarily unavailable.
- `504`: The upstream request timed out.

---

[API](https://skmtc.dev/fastaf/apis/fastaf-api.md) · [All operations](https://skmtc.dev/fastaf/apis/fastaf-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fastaf/apis/fastaf-api/revisions/5917bde2f4e0?raw)
