Provided by OpenAlex
Search Scholarly Articles, Papers and Preprints by Text
Search the OpenAlex index of scholarly articles by free text over titles, abstracts and full text, and get back peer-reviewed papers and preprints with their title, authors, host journal, publication date, citation count, open-access status and DOI. Narrow the search with a publication year or date range, an open-access flag, a work type, or an institution ROR, and sort by relevance, citation count or date. Results page 100 at a time, with a cursor for deeper paging.
How to run it
Step 1Set up
Once: paste this into your agent's chat. The Skill installs the CLI and logs in by itself. For an agent that cannot use a shell, connect it over MCP instead.
set up https://glasser.ai/SKILL.md
Show me how to use the OpenAlex endpoint /works?search=true on Glasser.glasser run -p openalex -e '/works?search=true' -i '{"search":"dense retrieval","per_page":10}' --endpoint-version 1Uses endpoint version 1. Inspect the current price before running. Install and log in first on Get Started.
Once per Run:
IDEMPOTENCY_KEY=$(uuidgen)Run it, and copy this same block to send it again:
curl -X POST https://api.glasser.ai/v1/runs \
-H "Authorization: Bearer gl_..." \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
-d '{"provider":"openalex","endpoint":"/works?search=true","input":{"search":"dense retrieval","per_page":10},"endpoint_version":1}'Reuse the same Idempotency-Key to send it again: the second send is a read of the first Run. A new key is a new Run and a new Charge. Uses endpoint version 1; inspect the current price before running.
Step 2Try a specific example task
When you need to begin a literature review, you might find academic records relevant to your research question to decide what to read next.
Copy this prompt into your agent to find records for your literature review.
Use openalex:/works?search=true on Glasser.
Find returned academic records relevant to my literature-review question.Endpoint structure
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"search"
],
"properties": {
"page": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"sort": {
"enum": [
"relevance_score:desc",
"cited_by_count:desc",
"cited_by_count:asc",
"publication_date:desc",
"publication_date:asc"
],
"type": "string"
},
"is_oa": {
"type": "boolean"
},
"cursor": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"search": {
"type": "string",
"maxLength": 500,
"minLength": 2
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"work_type": {
"enum": [
"article",
"preprint",
"review",
"book",
"book-chapter",
"dataset",
"dissertation",
"letter",
"editorial",
"erratum",
"report",
"standard",
"other"
],
"type": "string"
},
"institution_ror": {
"type": "string",
"pattern": "^(https:\\/\\/ror\\.org\\/)?0[a-hj-km-np-tv-z0-9]{6}[0-9]{2}$"
},
"publication_year": {
"type": "integer",
"maximum": 2100,
"minimum": 1000
},
"to_publication_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"from_publication_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"additionalProperties": false
}{
"search": "dense retrieval",
"per_page": 10
}This Endpoint publishes no output schema. You get the Provider's own response body, unchanged — we do not warrant a shape we cannot guarantee.
How pricing works
| Data returned or no match | The same price with or without matching data. | $0.0011 |
|---|---|---|
| Provider error | The Provider failed to answer. | $0.00 |
| Timed out | The Run exceeded its time limit. | $0.00 |
| Internal failure | An internal error prevented completion. | $0.00 |