Glyph Query API
The Query API from Glyph — 5 operation(s) for query.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/glyphapi-dev:glyphapi-dev-query-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Glyph Query API
description: 'A language for agents: encode content into the cheapest substrate the reading model can parse, with honest per-reader token math. Fillin is the retrieval product — a time-series index of the dev internet that closes the gap between an LLM''s training cutoff and now.'
version: 0.1.0
tags:
- name: Query
paths:
/query:
post:
summary: Query
operationId: query_query_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/QueryIn'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/QueryOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
tags:
- Query
/query/cves:
post:
summary: Query Cves Route
description: CVE / supply-chain advisories slice ($0.02/call).
operationId: query_cves_route_query_cves_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SliceQueryIn'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/QueryOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
tags:
- Query
/query/papers:
post:
summary: Query Papers Route
description: Research papers slice ($0.03/call) — arXiv ∪ HF daily ∪ bioRxiv.
operationId: query_papers_route_query_papers_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SliceQueryIn'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/QueryOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
tags:
- Query
/query/frontier:
post:
summary: Query Frontier Route
description: Frontier-lab / model-release slice ($0.05/call).
operationId: query_frontier_route_query_frontier_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SliceQueryIn'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/QueryOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
tags:
- Query
/query/markets:
post:
summary: Query Markets Route
description: 'Prediction-markets slice ($0.05/call) — Polymarket ∪ Kalshi ∪
Manifold ∪ Metaculus. Discovery across four venues in one call;
prices in `text` are first-sight snapshots — hit the venue URL for
live pre-trade pricing.'
operationId: query_markets_route_query_markets_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SliceQueryIn'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/QueryOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
tags:
- Query
components:
schemas:
Hit:
properties:
id:
type: string
title: Id
source:
type: string
title: Source
url:
type: string
title: Url
published_at:
type: string
title: Published At
title:
type: string
title: Title
text:
type: string
title: Text
score:
anyOf:
- type: number
- type: 'null'
title: Score
severity_score:
anyOf:
- type: number
- type: 'null'
title: Severity Score
affected:
items:
additionalProperties: true
type: object
type: array
title: Affected
type: object
required:
- id
- source
- url
- published_at
- title
- text
title: Hit
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
QueryOut:
properties:
cutoff:
type: string
title: Cutoff
query:
type: string
title: Query
gap_days:
type: number
title: Gap Days
results:
items:
$ref: '#/components/schemas/Hit'
type: array
title: Results
top_score:
type: number
title: Top Score
default: 0.0
corpus_match:
type: string
title: Corpus Match
default: none
glyph:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Glyph
substrate_estimate:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Substrate Estimate
model_id:
anyOf:
- type: string
- type: 'null'
title: Model Id
cutoff_source:
anyOf:
- type: string
- type: 'null'
title: Cutoff Source
model_cutoff:
anyOf:
- type: string
- type: 'null'
title: Model Cutoff
agent_next:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Agent Next
type: object
required:
- cutoff
- query
- gap_days
- results
title: QueryOut
SliceQueryIn:
properties:
cutoff:
type: string
format: date-time
title: Cutoff
description: ISO8601 — your model's training cutoff
query:
type: string
maxLength: 512
minLength: 1
title: Query
k:
type: integer
maximum: 50.0
minimum: 1.0
title: K
default: 10
min_severity:
anyOf:
- type: number
maximum: 10.0
minimum: 0.0
- type: 'null'
title: Min Severity
type: object
required:
- cutoff
- query
title: SliceQueryIn
description: 'Request body for the dedicated /query/{slice} routes.
Same shape as QueryIn minus the `sources` field — the slice is fixed by
the route, so allowing a `sources` override would defeat the per-slice
pricing model.'
QueryIn:
properties:
cutoff:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Cutoff
description: ISO8601 training cutoff. Documents with published_at strictly after this instant are returned. Optional when model_id is set; an explicit cutoff wins if both are sent.
model_id:
anyOf:
- type: string
- type: 'null'
title: Model Id
description: Catalog model id (for example claude-sonnet-5, gpt-5.4, gemini-2.5-pro, llama-4-scout, grok-4.6). Resolves to that model's training cutoff when cutoff is omitted. See data/model_cutoffs.json.
query:
type: string
maxLength: 512
minLength: 1
title: Query
description: What topic / question
k:
type: integer
maximum: 50.0
minimum: 1.0
title: K
default: 10
glyph:
type: boolean
title: Glyph
description: If true, also return the result pieces rendered as a photo glyph (a dense, VLM-readable image) under the `glyph` field. Lets a vision model read results as one image. See /v1/glyph for image bytes.
default: false
glyph_tier:
anyOf:
- type: string
- type: 'null'
title: Glyph Tier
description: 'Glyph density tier: ''6x'' | ''10x'' | ''15x''. Default ''10x''.'
sources:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Sources
description: 'Optional list of source names to restrict retrieval. Each must be a known source from the ingest registry (e.g. ''cves'', ''papers'', ''frontier'', ''arena'', ''arxiv'', ''rss'', ''hackernews'', ''github_releases''). When omitted, all sources are searched. Pricing is unchanged: a filtered /query is billed at the flat /query rate. For per-slice pricing, use the dedicated /query/{slice} routes.'
substrate:
type: string
title: Substrate
description: 'Delivery substrate for POST /v1/retrieve: ''text'' | ''glyph'' | ''answer'' | ''auto''. ''auto'' runs one retrieval and returns whichever substrate is cheapest for your reader model''s token billing (text on Claude/GPT pixel billing, dense glyph on Gemini/Qwen flat-tile billing, a synthesized answer for weak tool-callers). Ignored by /query, /answer, /v1/glyph.'
default: text
reader:
anyOf:
- type: string
- type: 'null'
title: Reader
description: Your reader model, used by substrate='auto' to pick the cheapest legible form (e.g. 'claude', 'gemini', 'qwen2.5-vl', 'gpt-4o', 'llama-3.3'). If omitted, the server auto-detects it from the 'X-Reader-Model' request header (declare it once at the transport layer) or the User-Agent; an unidentified caller is treated as pixel-billed (the safe default — auto returns text rather than overclaim a saving). Ignored unless substrate='auto'.
verbatim:
anyOf:
- type: boolean
- type: 'null'
title: Verbatim
description: 'For substrate=''auto'': set true if you need exact/verbatim text or code (auto then never picks glyph, which paraphrases). None auto-detects from the result sources/content. Ignored unless substrate=''auto''.'
type: object
required:
- query
title: QueryIn
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
securitySchemes:
HTTPBearer:
type: http
scheme: bearer