Search Papers
Paperguide Search API for finding research papers and filtering results for apps, workflows, and integrations.
curl -X GET "https://api.paperguide.ai/v1/search?query=large language models for scientific literature review&source=arxiv&field_of_study=computer_science&year=2024&limit=10&format=bibtex" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY"
import requests
import json
url = "https://api.paperguide.ai/v1/search?query=large language models for scientific literature review&source=arxiv&field_of_study=computer_science&year=2024&limit=10&format=bibtex"
headers = {
"Content-Type": "application/json",
"x-api-key": "YOUR_API_KEY"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://api.paperguide.ai/v1/search?query=large language models for scientific literature review&source=arxiv&field_of_study=computer_science&year=2024&limit=10&format=bibtex", {
method: "GET",
headers: {
"Content-Type": "application/json",
"x-api-key": "YOUR_API_KEY"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://api.paperguide.ai/v1/search?query=large language models for scientific literature review&source=arxiv&field_of_study=computer_science&year=2024&limit=10&format=bibtex", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("x-api-key", "YOUR_API_KEY")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://api.paperguide.ai/v1/search?query=large language models for scientific literature review&source=arxiv&field_of_study=computer_science&year=2024&limit=10&format=bibtex')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['x-api-key'] = 'YOUR_API_KEY'
response = http.request(request)
puts response.body
{
"results": [
{
"id": "arxiv:2401.12345",
"title": "Large Language Models for Scientific Literature Review",
"authors": [
"Jane Doe",
"John Smith"
],
"year": 2024,
"source": "arxiv",
"field_of_study": "computer_science",
"abstract": "This paper explores how large language models can assist with scientific literature review through semantic retrieval and synthesis workflows.",
"url": "https://arxiv.org/abs/2401.12345"
},
{
"id": "s2:987654321",
"title": "Semantic Search Methods for Scholarly Discovery",
"authors": [
"Alice Brown",
"David Lee"
],
"year": 2023,
"source": "semantic_scholar",
"field_of_study": "computer_science",
"abstract": "We present semantic search techniques for discovering and ranking relevant scholarly papers across large academic corpora.",
"url": "https://www.semanticscholar.org/paper/987654321"
}
]
}
{
"error": "invalid_request",
"message": "The request was invalid or missing required parameters."
}
{
"error": "unauthorized",
"message": "Missing or invalid API key."
}
{
"error": "rate_limited",
"message": "Rate limit exceeded. Please try again later."
}
{
"error": "internal_error",
"message": "An unexpected server error occurred."
}
curl --request GET \
--url "https://api.paperguide.ai/v1/search?query=retrieval%20augmented%20generation&field_of_study=computer_science&year=2024&limit=3" \
--header "x-api-key: pg_api_example_9xmk7q2r"
{
"results": [
{
"id": "649f2b7c1a2d4e8f9c0a1234",
"title": "Retrieval-Augmented Generation for Knowledge-Intensive NLP Tasks",
"authors": [
"Patrick Lewis",
"Ethan Perez",
"Aleksandara Piktus"
],
"year": 2024,
"source": "semantic_scholar",
"field_of_study": "computer_science",
"abstract": "This paper studies retrieval-augmented generation methods for knowledge-intensive natural language processing tasks.",
"url": "https://api.paperguide.ai/papers/649f2b7c1a2d4e8f9c0a1234"
},
{
"id": "649f2b7c1a2d4e8f9c0a5678",
"title": "Efficient Indexing Strategies for Retrieval-Augmented Systems",
"authors": [
"Jane Chen",
"Marcus Hill"
],
"year": 2024,
"source": "arxiv",
"field_of_study": "computer_science",
"abstract": "The paper evaluates indexing strategies that improve retrieval quality and latency in large-scale retrieval-augmented systems.",
"url": "https://api.paperguide.ai/papers/649f2b7c1a2d4e8f9c0a5678"
},
{
"id": "649f2b7c1a2d4e8f9c0a9012",
"title": "Grounding Language Models with External Research Corpora",
"authors": [
"Sara Ahmed",
"David Park"
],
"year": 2024,
"source": "pubmed",
"field_of_study": "computer_science",
"abstract": "This work explores retrieval pipelines that ground language model outputs in external research corpora.",
"url": "https://api.paperguide.ai/papers/649f2b7c1a2d4e8f9c0a9012"
}
]
}
/search
API key (sent in header)
Search query used to find relevant academic papers.
Filter results by source.
Filter results by field of study.
Filter results by publication year.
Maximum number of papers to return.
Response format. Use bibtex to receive BibTeX text output.
Request Preview
Response
Response will appear here after sending the request
Authentication
API Key for authentication. Provide your API key in the header.
Query Parameters
Search query used to find relevant academic papers.
Filter results by field of study.
computer_sciencemedicinebiologyphysicschemistrymathematicsengineeringeconomicspsychologyenvironmental_scienceFilter results by publication year.
Maximum number of papers to return.
Response format. Use bibtex to receive BibTeX text output.
Responses
List of matching papers.
Unique identifier for the paper in the source system.
Paper title.
List of author names.
Publication year.
Source where the paper was found.
arxivpubmedsemantic_scholarField of study associated with the paper.
computer_sciencemedicinebiologyphysicschemistrymathematicsengineeringeconomicspsychologyenvironmental_sciencePaper abstract.
Canonical URL for the paper.
Short machine-readable error code.
Human-readable error message.
Short machine-readable error code.
Human-readable error message.
Short machine-readable error code.
Human-readable error message.
Short machine-readable error code.
Human-readable error message.
Endpoint overview
Search academic papers with keyword and semantic matching by sending a GET request to the search endpoint. Use query parameters to narrow results by source, field of study, year, and output format.
Add your API key to the x-api-key header on every request.
x-api-key: pg_api_example_9xmk7q2r
Create API keys in Settings > API Keys in the Paperguide dashboard.
Method and path
Send requests to the Paperguide API base URL with the /search path.
GET https://api.paperguide.ai/v1/search
The endpoint returns JSON search results unless you request BibTeX output.
Query parameters
Use these query parameters to control the search request.
Search text used for keyword and semantic matching.
Filters results to a supported content source.
Filters results to a supported field of study.
Filters results to a publication year.
Limits the number of results returned.
Enterprise plans support up to 50 papers per request. Contact us for Enterprise access and usage-based pricing.
Controls the response format. Use bibtex to return BibTeX output.
Allowed source values
Use one of these values for the source parameter.
| Value | Description |
|---|---|
arxiv | Search papers from arXiv |
pubmed | Search papers from PubMed |
semantic_scholar | Search papers indexed through Semantic Scholar |
Allowed field-of-study values
Use one of these values for the field_of_study parameter.
| Value | Description |
|---|---|
computer_science | Computer science papers |
medicine | Medicine and clinical research |
biology | Biology and life sciences |
physics | Physics papers |
chemistry | Chemistry papers |
mathematics | Mathematics papers |
engineering | Engineering papers |
economics | Economics papers |
psychology | Psychology papers |
environmental_science | Environmental science papers |
Request example
This example searches for recent papers about retrieval-augmented generation in computer science.
The API returns matching papers as JSON. Each item includes core metadata such as title, authors, source, and abstract when available.
Response example
Response fields
List of matching papers.
Unique identifier for the paper.
Paper title.
List of author names.
Publication year.
Source where Paperguide found the paper.
Field of study assigned to the paper.
Paper abstract when available.
Paper URL.
BibTeX output notes
Set format=bibtex to return BibTeX instead of JSON. Use this when you want to import citations directly into a reference manager or manuscript workflow.
If you request BibTeX output, the response body is plain BibTeX text rather than a JSON object. Response fields described above do not apply to BibTeX responses.
Search quality explanation
The search endpoint uses keyword and semantic matching together. Keyword matching helps when you know exact terms, while semantic matching helps when relevant papers use different wording.
Results depend on the quality and specificity of your query value. Short or broad queries usually return more varied results, while focused queries with a field of study or year filter usually return more precise matches.
Documented error responses
The API returns JSON errors when a request fails. These are the documented error responses for the search endpoint.
| Status | Meaning |
|---|---|
400 | Invalid request parameters |
401 | Missing or invalid API key |
429 | Rate limit or monthly quota exceeded |
500 | Internal server error |
Last updated 2 days ago
Built with Documentation.AI