Cognoska Public API

Access AI research summaries and breakthrough papers via a secure REST API. Authentication uses API keys (Bearer tokens). The API is rate-limited per user.

Base URL

The root endpoint for all public API requests

https://cognoska.com/api/v1/

Authentication

All requests require an Authorization header containing your API key. You can create and manage keys in your Dashboard → Settings → API Access.

Authorization: Bearer cog_472d_-RuJu3I_XktBpcWE5Cd2RnEayczp-Gsb

⚠️ Keep your API key secret. Never expose it in client-side JavaScript.

Endpoints

/api/v1/search

Search for AI papers, filtered and ranked semantically.

Performs semantic + keyword search across the Cognoska paper database.

GET

GET https://cognoska.com/api/v1/search?q=transformer&category=cs.LG&k=10
Authorization: Bearer <your_api_key>

Query parameters

q — Search term (required)
category — Filter by arXiv category (e.g., cs.LG)
from, to — Date range (YYYY-MM-DD)
has_code — 1 = with code, 0 = without
min_score — Minimum internal score
breakthroughs — 1 = only top-scored papers
k — Number of results (max 50)

Example response

{
  "items": [
    {
      "id": "a3fc9c9d-7acd-46c4-9baa-57f989f3ffca",
      "title": "Latent Representation Learning in Heavy-Ion Collisions with MaskPoint Transformer",
      "summary": "The authors introduce a Transformer-based autoencoder...",
      "categories": "cs.LG",
      "url": "http://arxiv.org/abs/2510.06691v1",
      "has_code": true,
      "code_url": "https://github.com/Giovanni-Sforza/MaskPoint-AMPT",
      "score": 7.9,
      "relevance": 116.9
    }
  ]
}

/api/v1/usage

Get your recent API usage and remaining quota.

GET

GET https://cognoska.com/api/v1/usage
Authorization: Bearer <your_api_key>

Returns request logs aggregated by time window.

Rate limits

60 requests per minute
1 000 requests per day
Exceeded limits return 429 rate_limited

Error codes

401 unauthorized — Missing or invalid API key
429 rate_limited — Too many requests
500 internal_error — Unexpected server error

SDK examples

Example usage in Python and JavaScript:

# Python
import requests

API_KEY = "cog_xxx"
url = "https://cognoska.com/api/v1/search"
params = {"q": "transformer", "k": 5}
res = requests.get(url, headers={"Authorization": f"Bearer {API_KEY}"}, params=params)
print(res.json())

// JavaScript
const res = await fetch("https://cognoska.com/api/v1/search?q=transformer&k=5", {
  headers: { "Authorization": "Bearer cog_xxx" }
});
const data = await res.json();
console.log(data.items[0].title);