{"openapi":"3.1.0","info":{"title":"Apizie","version":"2.0.0","description":"One API key, one envelope, many public data sources."},"servers":[{"url":"https://apizie.tech"}],"security":[{"ApiKeyAuth":[]}],"paths":{"/v1/research:openalex/works":{"get":{"operationId":"research_openalex_works","summary":"Search works","description":"Papers, books and datasets.","tags":["research"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"retrieval augmented generation"},{"name":"perPage","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":10,"minimum":1,"maximum":200,"description":"Number of results"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"minimum":1}},{"name":"filter","in":"query","required":false,"schema":{"type":"string"},"example":"publication_year:2024,is_oa:true"},{"name":"sort","in":"query","required":false,"schema":{"type":"string"},"example":"cited_by_count:desc"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:openalex/work":{"get":{"operationId":"research_openalex_work","summary":"Work","description":"One work by OpenAlex id or DOI.","tags":["research"],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"example":"doi:10.1038/nature14539"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:openalex/authors":{"get":{"operationId":"research_openalex_authors","summary":"Search authors","description":"Authors with works and citation counts.","tags":["research"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"Yoshua Bengio"},{"name":"perPage","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":10,"minimum":1,"maximum":200,"description":"Number of results"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:openalex/institutions":{"get":{"operationId":"research_openalex_institutions","summary":"Search institutions","description":"Universities and research organizations.","tags":["research"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"MIT"},{"name":"perPage","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":10,"minimum":1,"maximum":200,"description":"Number of results"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:openalex/topics":{"get":{"operationId":"research_openalex_topics","summary":"Search topics","description":"Research topics with work counts.","tags":["research"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"climate change"},{"name":"perPage","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":10,"minimum":1,"maximum":200,"description":"Number of results"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"RunEnvelope":{"type":"object","required":["project","data","timestamp"],"properties":{"project":{"type":"string","example":"dev-tools:hash"},"data":{},"timestamp":{"type":"string","format":"date-time"}}},"ErrorEnvelope":{"type":"object","properties":{"content":{},"message":{"type":"string"},"errors":{"type":"array","items":{}},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"responses":{"Error":{"description":"Invalid key, plan gate, rate limit or upstream failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}