Skip to main content
GET
/
v1
/
datasources
List available data sources
curl --request GET \
  --url https://api.valyu.ai/v1/datasources \
  --header 'X-API-Key: <api-key>'
import requests

url = "https://api.valyu.ai/v1/datasources"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.valyu.ai/v1/datasources', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.valyu.ai/v1/datasources",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.valyu.ai/v1/datasources"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://api.valyu.ai/v1/datasources")
  .header("X-API-Key", "<api-key>")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.valyu.ai/v1/datasources")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body
{
  "success": true,
  "datasources": [
    {
      "id": "valyu/valyu-arxiv",
      "name": "arXiv",
      "description": "Preprints in physics, mathematics, computer science, quantitative biology, and more.",
      "category": "research",
      "topics": [
        "physics",
        "mathematics",
        "computer science"
      ],
      "modality": "text",
      "example_queries": [
        "CRISPR gene editing mechanisms",
        "quantum error correction methods"
      ],
      "pricing": {
        "cpm": 0.5
      },
      "update_frequency": "daily",
      "size": "2.5M papers"
    },
    {
      "id": "valyu/valyu-pubmed",
      "name": "PubMed",
      "description": "Biomedical literature from MEDLINE, life science journals, and online books.",
      "category": "healthcare",
      "topics": [
        "medicine",
        "biology",
        "pharmacology"
      ],
      "modality": "text",
      "example_queries": [
        "GLP-1 receptor agonists for type 2 diabetes",
        "CAR-T cell therapy advances"
      ],
      "pricing": {
        "cpm": 0.5
      },
      "update_frequency": "daily",
      "size": "36M citations"
    }
  ]
}
{
  "success": false,
  "error": "Invalid API key"
}
{
  "success": false,
  "error": "Internal server error. Please try again later."
}

Authorizations

X-API-Key
string
header
required

API key for authentication. Get yours at platform.valyu.ai.

Query Parameters

category
string

Filter datasources by category. Use the categories endpoint to discover available categories.

Response

List of available datasources.

success
boolean
required

Whether the request succeeded.

Example:

true

datasources
object[]
required

List of available datasources.

total_count
integer

Total number of datasources returned.

Example:

36

categories
object

Summary of categories with counts.