{"openapi":"3.1.0","info":{"title":"Apizie: search-tools","version":"2.0.0","description":"One API key, one envelope, many public data sources."},"servers":[{"url":"https://www.apizie.tech"}],"security":[{"ApiKeyAuth":[]}],"paths":{"/v1/search-tools:openverse/search":{"get":{"operationId":"search_tools_openverse_search","summary":"Search","description":"Search CC-licensed media.","tags":["search-tools"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"mountain"},{"name":"count","in":"query","required":false,"description":"Results per page","schema":{"type":"integer","default":20,"minimum":1,"maximum":20,"description":"Results per page"}},{"name":"page","in":"query","required":false,"description":"1-based page number","schema":{"type":"integer","default":1,"minimum":1,"maximum":20,"description":"1-based page number"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["images","audio"],"default":"images"}},{"name":"license","in":"query","required":false,"description":"Comma-separated license codes","schema":{"type":"string","description":"Comma-separated license codes"},"example":"by,cc0"}],"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":1800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/search-tools:npm/search":{"get":{"operationId":"search_tools_npm_search","summary":"Search","description":"Search the npm registry by text (supports qualifiers like keywords:, author:).","tags":["search-tools"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"http client"},{"name":"count","in":"query","required":false,"description":"Results per page","schema":{"type":"integer","default":20,"minimum":1,"maximum":250,"description":"Results per page"}},{"name":"page","in":"query","required":false,"description":"1-based page number","schema":{"type":"integer","default":1,"minimum":1,"maximum":500,"description":"1-based page number"}}],"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":600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/search-tools:npm/package/{name}":{"get":{"operationId":"search_tools_npm_package","summary":"Package","description":"Latest metadata of a package (abbreviated manifest).","tags":["search-tools"],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"},"example":"express"}],"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":1800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/search-tools:wikipedia/search":{"get":{"operationId":"search_tools_wikipedia_search","summary":"Search","description":"Full-text search of a Wikipedia language edition.","tags":["search-tools"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"Eiffel Tower"},{"name":"page","in":"query","required":false,"description":"1-based page number","schema":{"type":"integer","default":1,"minimum":1,"maximum":500,"description":"1-based page number"}},{"name":"limit","in":"query","required":false,"description":"Results per page","schema":{"type":"integer","default":10,"minimum":1,"maximum":50,"description":"Results per page"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","enum":["en","id","ms","jv","su","de","fr","es","pt","it","nl","ru","ja","zh","ko","ar"],"default":"en"}}],"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":600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/search-tools:wikipedia/summary/{title}":{"get":{"operationId":"search_tools_wikipedia_summary","summary":"Summary","description":"Lead extract, description and thumbnail of one article.","tags":["search-tools"],"parameters":[{"name":"title","in":"path","required":true,"schema":{"type":"string"},"example":"Eiffel Tower"},{"name":"lang","in":"query","required":false,"schema":{"type":"string","enum":["en","id","ms","jv","su","de","fr","es","pt","it","nl","ru","ja","zh","ko","ar"],"default":"en"}}],"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/search-tools:hackernews/search":{"get":{"operationId":"search_tools_hackernews_search","summary":"Search","description":"Search HN by relevance or date, optionally filtered by item type.","tags":["search-tools"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"rust"},{"name":"page","in":"query","required":false,"description":"1-based page number","schema":{"type":"integer","default":1,"minimum":1,"maximum":500,"description":"1-based page number"}},{"name":"limit","in":"query","required":false,"description":"Results per page","schema":{"type":"integer","default":20,"minimum":1,"maximum":100,"description":"Results per page"}},{"name":"tags","in":"query","required":false,"schema":{"type":"string","enum":["story","comment","ask_hn","show_hn","poll","front_page"]}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["relevance","date"],"default":"relevance"}}],"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":300,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/search-tools:stackoverflow/search":{"get":{"operationId":"search_tools_stackoverflow_search","summary":"Search","description":"Advanced question search (free text, tags, accepted-only).","tags":["search-tools"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"node fetch timeout"},{"name":"page","in":"query","required":false,"description":"1-based page number","schema":{"type":"integer","default":1,"minimum":1,"maximum":500,"description":"1-based page number"}},{"name":"limit","in":"query","required":false,"description":"Results per page","schema":{"type":"integer","default":20,"minimum":1,"maximum":100,"description":"Results per page"}},{"name":"site","in":"query","required":false,"schema":{"type":"string","enum":["stackoverflow","superuser","serverfault","askubuntu"],"default":"stackoverflow"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["relevance","activity","votes","creation"],"default":"relevance"}},{"name":"tagged","in":"query","required":false,"description":"Semicolon-separated tags","schema":{"type":"string","description":"Semicolon-separated tags"},"example":"javascript;node.js"},{"name":"accepted","in":"query","required":false,"description":"Only questions with an accepted answer","schema":{"type":"boolean","description":"Only questions with an accepted answer"}}],"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":600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/search-tools:arxiv/search":{"get":{"operationId":"search_tools_arxiv_search","summary":"Search","description":"Search preprints. Plain text searches all fields; arXiv prefixes like ti:, au:, cat: are passed through.","tags":["search-tools"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"large language models"},{"name":"count","in":"query","required":false,"description":"Results per page","schema":{"type":"integer","default":10,"minimum":1,"maximum":100,"description":"Results per page"}},{"name":"page","in":"query","required":false,"description":"1-based page number","schema":{"type":"integer","default":1,"minimum":1,"maximum":500,"description":"1-based page number"}},{"name":"sortBy","in":"query","required":false,"schema":{"type":"string","enum":["relevance","lastUpdatedDate","submittedDate"],"default":"relevance"}},{"name":"sortOrder","in":"query","required":false,"schema":{"type":"string","enum":["ascending","descending"],"default":"descending"}}],"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":1800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/search-tools:wikidata/search":{"get":{"operationId":"search_tools_wikidata_search","summary":"Search entities","description":"Find items and properties by label.","tags":["search-tools"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"Douglas Adams"},{"name":"language","in":"query","required":false,"schema":{"type":"string","default":"en"}},{"name":"limit","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":7,"minimum":1,"maximum":50,"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/search-tools:wikidata/entity":{"get":{"operationId":"search_tools_wikidata_entity","summary":"Entity","description":"All statements for one entity id.","tags":["search-tools"],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"example":"Q42"}],"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/search-tools:wikidata/sparql":{"get":{"operationId":"search_tools_wikidata_sparql","summary":"SPARQL","description":"Run a read-only SPARQL query.","tags":["search-tools"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"SELECT ?item WHERE { ?item wdt:P31 wd:Q146 } LIMIT 5"}],"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/search-tools:wikimedia-pageviews/article":{"get":{"operationId":"search_tools_wikimedia_pageviews_article","summary":"Article views","description":"Daily views between two dates.","tags":["search-tools"],"parameters":[{"name":"project","in":"query","required":false,"schema":{"type":"string","default":"en.wikipedia"}},{"name":"article","in":"query","required":true,"schema":{"type":"string"},"example":"Albert_Einstein"},{"name":"start","in":"query","required":true,"schema":{"type":"string"},"example":"20260101"},{"name":"end","in":"query","required":true,"schema":{"type":"string"},"example":"20260131"}],"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":21600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/search-tools:wikimedia-pageviews/top":{"get":{"operationId":"search_tools_wikimedia_pageviews_top","summary":"Most read","description":"Top articles on one day.","tags":["search-tools"],"parameters":[{"name":"project","in":"query","required":false,"schema":{"type":"string","default":"en.wikipedia"}},{"name":"year","in":"query","required":true,"schema":{"type":"string"},"example":"2026"},{"name":"month","in":"query","required":true,"schema":{"type":"string"},"example":"01"},{"name":"day","in":"query","required":true,"schema":{"type":"string"},"example":"15"}],"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/search-tools:internet-archive/search":{"get":{"operationId":"search_tools_internet_archive_search","summary":"Search items","description":"Advanced search.","tags":["search-tools"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"title:(moby dick) AND mediatype:texts"},{"name":"rows","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":20,"minimum":1,"maximum":1000,"description":"Number of results"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"minimum":1}}],"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/search-tools:internet-archive/metadata":{"get":{"operationId":"search_tools_internet_archive_metadata","summary":"Item metadata","description":"Files and metadata for an item.","tags":["search-tools"],"parameters":[{"name":"identifier","in":"query","required":true,"schema":{"type":"string"},"example":"principleofrelat00eins"}],"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/search-tools:library-of-congress/search":{"get":{"operationId":"search_tools_library_of_congress_search","summary":"Search","description":"Search all collections.","tags":["search-tools"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"moon landing"},{"name":"count","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":25,"minimum":1,"maximum":150,"description":"Number of results"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"minimum":1}}],"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/search-tools:hn-search/search":{"get":{"operationId":"search_tools_hn_search_search","summary":"Search by relevance","description":"Stories, comments or Ask/Show HN matching a query.","tags":["search-tools"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"model context protocol"},{"name":"tags","in":"query","required":false,"schema":{"type":"string","enum":["story","comment","ask_hn","show_hn","front_page"],"default":"story"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":0,"minimum":0,"maximum":50}},{"name":"hitsPerPage","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":20,"minimum":1,"maximum":100,"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":300,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/search-tools:hn-search/search-by-date":{"get":{"operationId":"search_tools_hn_search_search_by_date","summary":"Search newest first","description":"Same as search, sorted by date.","tags":["search-tools"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"rust"},{"name":"tags","in":"query","required":false,"schema":{"type":"string","enum":["story","comment","ask_hn","show_hn"],"default":"story"}},{"name":"hitsPerPage","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":20,"minimum":1,"maximum":100,"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":120,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/search-tools:hn-search/item":{"get":{"operationId":"search_tools_hn_search_item","summary":"Item with comments","description":"One story with its full comment tree.","tags":["search-tools"],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"integer"},"example":8863}],"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":300,"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"}}}}}}}