{"openapi":"3.1.0","info":{"title":"Ohita","description":"**Ohita** is a unified REST API that gives AI agents single-key access to\nReddit, Hacker News, GitHub, YouTube, GNews, Dev.to, and Slack.\n\n## Quick start\n\n1. **Sign up** — `POST /v1/auth/signup`\n2. **Get an API key** — `POST /v1/keys` (with JWT from step 1)\n3. **Call any provider** — pass `Authorization: Bearer <api_key>`\n\n## Authentication\n\nAll provider endpoints accept the `Authorization: Bearer ...` header:\n\n| Credential type | Header | Example |\n|-----------------|--------|---------|\n| JWT (short-lived) | `Authorization: Bearer <jwt>` | Returned by `/v1/auth/login` |\n| API key (persistent) | `Authorization: Bearer ok_live_...` | Returned by `POST /v1/keys` |\n\n## Response envelope\n\nEvery response follows a consistent JSON envelope:\n\n```json\n{\"ok\": true, \"data\": { ... }}\n```\n\nErrors:\n\n```json\n{\"ok\": false, \"error\": {\"code\": \"RATE_LIMITED\", \"message\": \"...\", \"retry_after\": 42}}\n```\n\n### Error codes\n\n| Code | Meaning |\n|------|---------|\n| `AUTH_INVALID` | Bad or missing credentials |\n| `AUTH_EXPIRED` | JWT has expired |\n| `RATE_LIMITED` | Per-user or per-provider limit hit — see `Retry-After` header |\n| `RESOURCE_NOT_FOUND` | The requested item does not exist upstream |\n| `LIMIT_EXCEEDED` | Account limit (e.g. max 5 API keys) |\n| `CREDENTIAL_REQUIRED` | Provider requires BYOK credentials (add via `/v1/credentials`) |\n| `PROVIDER_UNAVAILABLE` | Upstream service is down; stale cache may be served |\n| `PROVIDER_ERROR` | Upstream returned an error |\n| `VALIDATION_ERROR` | Request validation failed |\n| `INTERNAL_ERROR` | Unexpected server error |\n\n## Rate limits\n\n| Scope | Limit |\n|-------|-------|\n| Per-user (all endpoints) | 10 req/min |\n| GitHub | 60 req/min |\n| Hacker News | 120 req/min |\n| Wikipedia | 50 req/min |\n| Dev.to | 50 req/min |\n| YouTube | 30 req/min (10 000 quota units/day) |\n| GNews | 5 req/min |\n| Slack | 20 req/min |\n| Search (Tavily) | 30 req/min |\n| CoinGecko | 25 req/min |\n| ArXiv | 30 req/min |\n| Stack Exchange | 30 req/min |\n| Brave Search | 30 req/min |\n| Finnhub | 50 req/min |\n\nWhen rate-limited, the response includes a `Retry-After` header (seconds).\n","license":{"name":"Proprietary"},"version":"1.0.0"},"servers":[{"url":"https://api.ohita.tech","description":"Production"},{"url":"http://localhost:8000","description":"Local development"}],"paths":{"/v1/auth/signup":{"post":{"tags":["Authentication"],"summary":"Create account","description":"Create a new Ohita account. Returns a JWT access token you can use immediately to create API keys via `POST /v1/keys`.","operationId":"signup_v1_auth_signup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/login":{"post":{"tags":["Authentication"],"summary":"Log in","description":"Authenticate with email and password. Returns a JWT access token and sets an HTTP-only refresh token cookie.","operationId":"login_v1_auth_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/refresh":{"post":{"tags":["Authentication"],"summary":"Refresh JWT","description":"Exchange an HTTP-only refresh token cookie for a new JWT access token.","operationId":"refresh_v1_auth_refresh_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenResponse"}}}}}}},"/v1/keys":{"get":{"tags":["API Keys"],"summary":"List API keys","operationId":"list_api_keys_v1_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeyListResponse"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["API Keys"],"summary":"Create API key","description":"Generate a new persistent API key (prefixed `ok_live_`). Use this key as `Authorization: Bearer <ok_live_...>` for provider requests where API-key auth is supported. This key-management endpoint itself is authenticated via the current user auth flow (`Authorization: Bearer ...`). Active key limits are tier-dependent.","operationId":"create_api_key_v1_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateKeyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/keys/{key_id}":{"delete":{"tags":["API Keys"],"summary":"Revoke API key","operationId":"revoke_api_key_v1_keys__key_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"integer","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/credentials":{"get":{"tags":["Credentials"],"summary":"List all stored credentials","description":"List all provider credentials for the authenticated user. Credential values are never returned — only metadata (provider, status, timestamps).","operationId":"list_user_credentials_v1_credentials_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialListResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/credentials/{provider}":{"get":{"tags":["Credentials"],"summary":"Get credential status for a provider","description":"Get credential metadata for a specific provider. Returns 404 if no credential is stored.","operationId":"get_user_credential_v1_credentials__provider__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","description":"Provider name","title":"Provider"},"description":"Provider name"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialInfoResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Credentials"],"summary":"Add or update credentials for a provider","description":"Store (or replace) encrypted credentials for a provider. The credential values are encrypted at rest and never returned in API responses.","operationId":"add_or_update_credential_v1_credentials__provider__post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","description":"Provider name","title":"Provider"},"description":"Provider name"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddCredentialRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialInfoResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Credentials"],"summary":"Remove credentials for a provider","description":"Permanently delete the stored credential for a provider.","operationId":"remove_credential_v1_credentials__provider__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","description":"Provider name","title":"Provider"},"description":"Provider name"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/credentials/{provider}/test":{"post":{"tags":["Credentials"],"summary":"Test credentials against the upstream API","description":"Validate credentials by making a lightweight call to the provider's API. Does not store the credentials — use POST /{provider} to save them.","operationId":"test_provider_credential_v1_credentials__provider__test_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","description":"Provider name","title":"Provider"},"description":"Provider name"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddCredentialRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialTestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/healthz":{"get":{"tags":["Health"],"summary":"Health Check","description":"Unauthenticated health check for uptime monitoring.","operationId":"health_check_healthz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/payments/initiate":{"post":{"tags":["Payments"],"summary":"Initiate a BTC payment for a tier upgrade","description":"Generate a unique BTC address and payment order for upgrading to a paid tier.","operationId":"initiate_v1_payments_initiate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InitiatePaymentRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InitiatePaymentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/payments/{order_id}":{"get":{"tags":["Payments"],"summary":"Check payment order status","description":"Poll the status of a payment order.","operationId":"get_status_v1_payments__order_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"integer","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/subscriptions":{"get":{"tags":["Subscriptions"],"summary":"Get current subscription","description":"Return the current subscription for the authenticated user.","operationId":"get_current_subscription_v1_subscriptions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["Subscriptions"],"summary":"Create or upgrade subscription","description":"Create a new subscription or upgrade an existing one to the specified tier.","operationId":"create_subscription_v1_subscriptions_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSubscriptionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/subscriptions/cancel":{"post":{"tags":["Subscriptions"],"summary":"Cancel subscription","description":"Cancel the current subscription. Downgrade to free at end of billing period.","operationId":"cancel_current_subscription_v1_subscriptions_cancel_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/coupons/redeem":{"post":{"tags":["Coupons"],"summary":"Redeem a coupon code","description":"Redeem a promotion coupon code for a free subscription upgrade.","operationId":"redeem_coupon_endpoint_v1_coupons_redeem_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RedeemCouponRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/logs":{"get":{"tags":["Logs"],"summary":"Get Logs","description":"Return the authenticated user's recent API call logs.\n\nFree-tier users receive 403. Pro sees 7 days, Scale sees 30 days.","operationId":"get_logs_v1_logs_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LogsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/usage":{"get":{"tags":["Usage"],"summary":"Get Usage","description":"Return current-month usage counters for the authenticated user.\n\nThe ``used`` count is sourced from the same Redis cache key used by quota\nenforcement so that the displayed value is consistent with what blocks\nrequests.  Falls back to a DB count when Redis is unavailable.\n``by_provider`` is always DB-based (best-effort).","operationId":"get_usage_v1_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/hackathon/submission":{"get":{"tags":["Hackathon"],"summary":"Get your hackathon submission","description":"Retrieve the current user's hackathon submission.","operationId":"get_my_submission_v1_hackathon_submission_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmissionResponse"}}}}},"security":[{"HTTPBearer":[]}]},"put":{"tags":["Hackathon"],"summary":"Update hackathon submission","description":"Update an existing hackathon submission.","operationId":"update_my_submission_v1_hackathon_submission_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmissionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["Hackathon"],"summary":"Submit hackathon project","description":"Create a hackathon submission. One per user.","operationId":"submit_project_v1_hackathon_submission_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmissionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]},"delete":{"tags":["Hackathon"],"summary":"Withdraw hackathon submission","description":"Delete your hackathon submission.","operationId":"withdraw_submission_v1_hackathon_submission_delete","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/reddit/search":{"get":{"tags":["reddit"],"summary":"Search Reddit","description":"Search posts and comments across all of Reddit, or within a specific subreddit.","operationId":"search_reddit_v1_reddit_search_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":500,"description":"Search query","title":"Q"},"description":"Search query"},{"name":"subreddit","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":21},{"type":"null"}],"description":"Restrict to subreddit","title":"Subreddit"},"description":"Restrict to subreddit"},{"name":"sort","in":"query","required":false,"schema":{"type":"string","pattern":"^(relevance|hot|new|top)$","default":"relevance","title":"Sort"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Reddit search results","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"posts":[{"id":"1abc234","title":"How AI agents are changing development","author":"devuser","subreddit":"programming","score":342,"upvote_ratio":0.94,"num_comments":87,"url":"https://reddit.com/r/programming/comments/1abc234/...","selftext":"I've been experimenting with...","created_utc":1711929600,"permalink":"/r/programming/comments/1abc234/...","is_self":true}],"after":"t3_1abc234"}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/reddit/r/{subreddit}/hot":{"get":{"tags":["reddit"],"summary":"Subreddit Hot","description":"Get hot posts from a specific subreddit.","operationId":"subreddit_hot_v1_reddit_r__subreddit__hot_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"subreddit","in":"path","required":true,"schema":{"type":"string","title":"Subreddit"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Subreddit posts","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"posts":[{"id":"1abc234","title":"Show r/python: My new CLI tool","author":"pythondev","subreddit":"python","score":128,"upvote_ratio":0.91,"num_comments":23,"url":"https://github.com/example/tool","selftext":"","created_utc":1711929600,"permalink":"/r/python/comments/1abc234/...","is_self":false}],"after":"t3_1abc234"}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/reddit/r/{subreddit}/new":{"get":{"tags":["reddit"],"summary":"Subreddit New","description":"Get new posts from a specific subreddit.","operationId":"subreddit_new_v1_reddit_r__subreddit__new_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"subreddit","in":"path","required":true,"schema":{"type":"string","title":"Subreddit"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Subreddit posts","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"posts":[{"id":"1abc234","title":"Show r/python: My new CLI tool","author":"pythondev","subreddit":"python","score":128,"upvote_ratio":0.91,"num_comments":23,"url":"https://github.com/example/tool","selftext":"","created_utc":1711929600,"permalink":"/r/python/comments/1abc234/...","is_self":false}],"after":"t3_1abc234"}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/reddit/post/{post_id}/comments":{"get":{"tags":["reddit"],"summary":"Post Comments","description":"Get comments on a specific post.","operationId":"post_comments_v1_reddit_post__post_id__comments_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"post_id","in":"path","required":true,"schema":{"type":"string","title":"Post Id"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","pattern":"^(best|top|new)$","default":"best","title":"Sort"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Post comments","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"post":{"id":"1abc234","title":"Discussion thread","author":"op_user"},"comments":[{"id":"c1","author":"commenter1","body":"Great point!","score":45,"created_utc":1711929600,"is_submitter":false}]}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/reddit/user/{username}/about":{"get":{"tags":["reddit"],"summary":"User About","description":"Get public info about a Reddit user.","operationId":"user_about_v1_reddit_user__username__about_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"username","in":"path","required":true,"schema":{"type":"string","title":"Username"}}],"responses":{"200":{"description":"Reddit user profile","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"username":"devuser","id":"t2_abc","created_utc":1609459200,"link_karma":1234,"comment_karma":5678,"total_karma":6912,"is_verified":false,"has_verified_email":true}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/twitter/search":{"get":{"tags":["twitter"],"summary":"Search Twitter","description":"Search recent tweets from the last 7 days. Supports sorting by recency or relevancy.","operationId":"search_twitter_v1_twitter_search_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":500,"description":"Search query","title":"Q"},"description":"Search query"},{"name":"sort","in":"query","required":false,"schema":{"type":"string","pattern":"^(recency|relevancy)$","default":"relevancy","title":"Sort"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Tweet search results","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"tweets":[{"id":"1234567890","text":"AI agents are the future of developer tooling","author_id":"987654","created_at":"2026-04-03T12:00:00Z","retweet_count":42,"reply_count":7,"like_count":189,"quote_count":3}],"result_count":1,"next_token":"b26v89c19zqg8o3fpzbq..."}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/twitter/user/{username}/tweets":{"get":{"tags":["twitter"],"summary":"User Tweets","description":"Get recent tweets from a specific user.","operationId":"user_tweets_v1_twitter_user__username__tweets_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"username","in":"path","required":true,"schema":{"type":"string","title":"Username"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/twitter/user/{username}/about":{"get":{"tags":["twitter"],"summary":"User About","description":"Get public profile for a Twitter user.","operationId":"user_about_v1_twitter_user__username__about_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"username","in":"path","required":true,"schema":{"type":"string","title":"Username"}}],"responses":{"200":{"description":"Twitter user profile","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"id":"987654","name":"Dev User","username":"devuser","description":"Building things","followers_count":1200,"following_count":300,"tweet_count":4500,"verified":false}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/twitter/tweet/{tweet_id}":{"get":{"tags":["twitter"],"summary":"Tweet Lookup","description":"Look up a single tweet by ID.","operationId":"tweet_lookup_v1_twitter_tweet__tweet_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"tweet_id","in":"path","required":true,"schema":{"type":"string","title":"Tweet Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/twitter/tweet/{tweet_id}/replies":{"get":{"tags":["twitter"],"summary":"Tweet Replies","description":"Get replies to a specific tweet.","operationId":"tweet_replies_v1_twitter_tweet__tweet_id__replies_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"tweet_id","in":"path","required":true,"schema":{"type":"string","title":"Tweet Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/slack/channels":{"get":{"tags":["slack"],"summary":"List Channels","description":"List channels in the workspace. Supports pagination via cursor.","operationId":"list_channels_v1_slack_channels_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"types","in":"query","required":false,"schema":{"type":"string","pattern":"^(public_channel|private_channel|mpim|im)(,(public_channel|private_channel|mpim|im))*$","description":"Comma-separated channel types","default":"public_channel","title":"Types"},"description":"Comma-separated channel types"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"description":"Pagination cursor","title":"Cursor"},"description":"Pagination cursor"}],"responses":{"200":{"description":"List of Slack channels","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"channels":[{"id":"C01ABCDEF23","name":"general","is_channel":true,"is_private":false,"is_archived":false,"num_members":42,"topic":"Company-wide announcements","purpose":"General discussion","created":1620000000}],"next_cursor":""}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/slack/channels/{channel_id}/history":{"get":{"tags":["slack"],"summary":"Channel History","description":"Fetch message history from a channel.","operationId":"channel_history_v1_slack_channels__channel_id__history_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"channel_id","in":"path","required":true,"schema":{"type":"string","title":"Channel Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"description":"Pagination cursor","title":"Cursor"},"description":"Pagination cursor"},{"name":"oldest","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Start of time range (message timestamp)","title":"Oldest"},"description":"Start of time range (message timestamp)"},{"name":"latest","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"End of time range (message timestamp)","title":"Latest"},"description":"End of time range (message timestamp)"}],"responses":{"200":{"description":"Channel message history","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"messages":[{"type":"message","user":"U01ABCDEF23","text":"Hello, world!","ts":"1620000000.000100","reply_count":0,"reactions":[]}],"has_more":false,"next_cursor":""}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/slack/channels/{channel_id}/replies/{thread_ts}":{"get":{"tags":["slack"],"summary":"Channel Replies","description":"Get thread replies for a message.","operationId":"channel_replies_v1_slack_channels__channel_id__replies__thread_ts__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"channel_id","in":"path","required":true,"schema":{"type":"string","title":"Channel Id"}},{"name":"thread_ts","in":"path","required":true,"schema":{"type":"string","title":"Thread Ts"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"description":"Pagination cursor","title":"Cursor"},"description":"Pagination cursor"}],"responses":{"200":{"description":"Thread replies","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"messages":[{"type":"message","user":"U01ABCDEF23","text":"Original message","ts":"1620000000.000100","thread_ts":"1620000000.000100","reply_count":1,"reactions":[]},{"type":"message","user":"U02XYZABC45","text":"Reply to the thread","ts":"1620000060.000200","thread_ts":"1620000000.000100","reply_count":0,"reactions":[]}],"has_more":false,"next_cursor":""}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/slack/search":{"get":{"tags":["slack"],"summary":"Search Messages","description":"Search messages across the workspace. Requires a user token (xoxp-), not a bot token.","operationId":"search_messages_v1_slack_search_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":500,"description":"Search query","title":"Q"},"description":"Search query"},{"name":"sort","in":"query","required":false,"schema":{"type":"string","pattern":"^(timestamp|score)$","default":"timestamp","title":"Sort"}},{"name":"count","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Count"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":1,"title":"Page"}}],"responses":{"200":{"description":"Message search results (requires user token xoxp-)","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"messages":[{"text":"The quarterly report is ready","user":"alice","ts":"1620000000.000100","channel":"general","channel_id":"C01ABCDEF23","permalink":"https://myworkspace.slack.com/archives/C01ABCDEF23/p1620000000000100"}],"total":1,"page":1,"pages":1}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/slack/users":{"get":{"tags":["slack"],"summary":"List Users","description":"List workspace members.","operationId":"list_users_v1_slack_users_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":100,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"description":"Pagination cursor","title":"Cursor"},"description":"Pagination cursor"}],"responses":{"200":{"description":"Workspace members","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"members":[{"id":"U01ABCDEF23","name":"alice","real_name":"Alice Smith","display_name":"alice","email":"alice@example.com","is_admin":false,"is_bot":false,"timezone":"America/New_York","status_text":"In a meeting","status_emoji":":calendar:"}],"next_cursor":""}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/slack/users/{user_id}":{"get":{"tags":["slack"],"summary":"User Info","description":"Get info about a specific user.","operationId":"user_info_v1_slack_users__user_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"200":{"description":"User profile info","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"id":"U01ABCDEF23","name":"alice","real_name":"Alice Smith","display_name":"alice","email":"alice@example.com","is_admin":false,"is_bot":false,"timezone":"America/New_York","status_text":"In a meeting","status_emoji":":calendar:"}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/slack/messages":{"post":{"tags":["slack"],"summary":"Post Message","description":"Send a message to a channel. Requires chat:write scope.","operationId":"post_message_v1_slack_messages_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostMessageBody"}}},"required":true},"responses":{"200":{"description":"Posted message","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"channel":"C01ABCDEF23","ts":"1620000120.000300","message":{"type":"message","user":"U01BOTUSER0","text":"Hello from Ohita!","ts":"1620000120.000300","reply_count":0,"reactions":[]}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/brave/search":{"get":{"tags":["brave"],"summary":"Search Web","description":"Web search via Brave Search. BYOK only — add your API key via POST /v1/credentials/brave.","operationId":"search_web_v1_brave_search_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":400,"description":"Search query","title":"Query"},"description":"Search query"},{"name":"count","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":10,"title":"Count"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":9,"minimum":0,"default":0,"title":"Offset"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"2-letter country code","title":"Country"},"description":"2-letter country code"},{"name":"freshness","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(pd|pw|pm|py)$"},{"type":"null"}],"description":"pd=past day, pw=past week, pm=past month, py=past year","title":"Freshness"},"description":"pd=past day, pw=past week, pm=past month, py=past year"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/brave/news":{"get":{"tags":["brave"],"summary":"Search News","description":"News search via Brave Search. BYOK only — add your API key via POST /v1/credentials/brave.","operationId":"search_news_v1_brave_news_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":400,"description":"Search query","title":"Query"},"description":"Search query"},{"name":"count","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":10,"title":"Count"}},{"name":"freshness","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(pd|pw|pm|py)$"},{"type":"null"}],"description":"pd=past day, pw=past week, pm=past month, py=past year","title":"Freshness"},"description":"pd=past day, pw=past week, pm=past month, py=past year"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hackernews/top":{"get":{"tags":["hackernews"],"summary":"Top Stories","description":"Get current top stories from Hacker News, ranked by score. Returns up to 500 stories.","operationId":"top_stories_v1_hackernews_top_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":30,"title":"Limit"}}],"responses":{"200":{"description":"Hacker News stories","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"stories":[{"id":40123456,"type":"story","title":"Show HN: Open-source AI agent framework","url":"https://github.com/example/agent","author":"pg","score":287,"comment_count":134,"created_utc":1711929600}]}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/hackernews/new":{"get":{"tags":["hackernews"],"summary":"New Stories","description":"Get newest stories from Hacker News.","operationId":"new_stories_v1_hackernews_new_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":30,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hackernews/best":{"get":{"tags":["hackernews"],"summary":"Best Stories","description":"Get best stories from Hacker News.","operationId":"best_stories_v1_hackernews_best_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":30,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hackernews/ask":{"get":{"tags":["hackernews"],"summary":"Ask Stories","description":"Get Ask HN stories.","operationId":"ask_stories_v1_hackernews_ask_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":30,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hackernews/show":{"get":{"tags":["hackernews"],"summary":"Show Stories","description":"Get Show HN stories.","operationId":"show_stories_v1_hackernews_show_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":30,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hackernews/jobs":{"get":{"tags":["hackernews"],"summary":"Job Stories","description":"Get job postings from Hacker News.","operationId":"job_stories_v1_hackernews_jobs_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":30,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hackernews/item/{item_id}":{"get":{"tags":["hackernews"],"summary":"Get Item","description":"Get a single Hacker News item.","operationId":"get_item_v1_hackernews_item__item_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"integer","exclusiveMinimum":0,"title":"Item Id"}}],"responses":{"200":{"description":"Single HN item (story, comment, poll, or job)","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"id":40123456,"type":"story","title":"Show HN: Open-source AI agent framework","url":"https://github.com/example/agent","author":"pg","score":287,"comment_count":134,"created_utc":1711929600,"children_ids":[40123457,40123458]}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/hackernews/user/{username}":{"get":{"tags":["hackernews"],"summary":"Get User","description":"Get a Hacker News user profile.","operationId":"get_user_v1_hackernews_user__username__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"username","in":"path","required":true,"schema":{"type":"string","title":"Username"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hackernews/search":{"get":{"tags":["hackernews"],"summary":"Search","description":"Full-text search across Hacker News stories and comments via Algolia. Supports filtering by tags (story, comment, show_hn, ask_hn, job).","operationId":"search_v1_hackernews_search_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"description":"Search query","title":"Q"},"description":"Search query"},{"name":"tags","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"description":"Comma-separated tags","title":"Tags"},"description":"Comma-separated tags"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Page"}},{"name":"hitsPerPage","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Hitsperpage"}}],"responses":{"200":{"description":"Algolia search results","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"hits":[{"id":"40123456","title":"AI agent framework","url":"https://github.com/example/agent","author":"pg","points":287,"comment_count":134,"created_at":"2026-04-03T12:00:00Z"}],"total_hits":420,"page":0,"total_pages":21}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/devto/articles":{"get":{"tags":["devto"],"summary":"List Articles","description":"List/filter Dev.to articles.","operationId":"list_articles_v1_devto_articles_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":30,"title":"Per Page"}},{"name":"tag","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Tag"}},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(fresh|rising|all)$"},{"type":"null"}],"title":"State"}},{"name":"top","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Top"}}],"responses":{"200":{"description":"Dev.to articles","content":{"application/json":{"schema":{},"example":{"ok":true,"data":[{"id":12345,"title":"Getting Started with AI Agents","description":"A practical guide to building...","url":"https://dev.to/devuser/getting-started-with-ai-agents","author":"devuser","tags":["ai","python","tutorial"],"positive_reactions_count":42,"comments_count":7,"reading_time_minutes":5,"published_at":"2026-04-01T12:00:00Z"}]}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/devto/articles/{article_id}":{"get":{"tags":["devto"],"summary":"Get Article","description":"Get a single Dev.to article by ID.","operationId":"get_article_v1_devto_articles__article_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"article_id","in":"path","required":true,"schema":{"type":"integer","exclusiveMinimum":0,"title":"Article Id"}}],"responses":{"200":{"description":"Single Dev.to article with full body","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"id":12345,"title":"Getting Started with AI Agents","description":"A practical guide to building...","url":"https://dev.to/devuser/getting-started-with-ai-agents","author":"devuser","tags":["ai","python","tutorial"],"body_html":"<p>In this article...</p>","body_markdown":"In this article...","positive_reactions_count":42,"comments_count":7,"reading_time_minutes":5,"published_at":"2026-04-01T12:00:00Z"}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/devto/articles/{username}/{slug}":{"get":{"tags":["devto"],"summary":"Get Article By Slug","description":"Get a Dev.to article by username and slug.","operationId":"get_article_by_slug_v1_devto_articles__username___slug__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"username","in":"path","required":true,"schema":{"type":"string","title":"Username"}},{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/devto/articles/{article_id}/comments":{"get":{"tags":["devto"],"summary":"Get Article Comments","description":"Get comments for a Dev.to article.","operationId":"get_article_comments_v1_devto_articles__article_id__comments_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"article_id","in":"path","required":true,"schema":{"type":"integer","exclusiveMinimum":0,"title":"Article Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/devto/users/{user_id}":{"get":{"tags":["devto"],"summary":"Get User By Id","description":"Get a Dev.to user profile by ID.","operationId":"get_user_by_id_v1_devto_users__user_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","exclusiveMinimum":0,"title":"User Id"}}],"responses":{"200":{"description":"Dev.to user profile","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"id":1,"username":"devuser","name":"Dev User","summary":"Building things with code","github_username":"devuser","website_url":"https://devuser.com","joined_at":"2020-01-01T00:00:00Z"}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/devto/users/by-username/{username}":{"get":{"tags":["devto"],"summary":"Get User By Username","description":"Get a Dev.to user profile by username.","operationId":"get_user_by_username_v1_devto_users_by_username__username__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"username","in":"path","required":true,"schema":{"type":"string","title":"Username"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/devto/tags":{"get":{"tags":["devto"],"summary":"List Tags","description":"List Dev.to tags.","operationId":"list_tags_v1_devto_tags_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":30,"title":"Per Page"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/devto/organizations/{username}":{"get":{"tags":["devto"],"summary":"Get Organization","description":"Get a Dev.to organization profile.","operationId":"get_organization_v1_devto_organizations__username__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"username","in":"path","required":true,"schema":{"type":"string","title":"Username"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/devto/organizations/{username}/articles":{"get":{"tags":["devto"],"summary":"Get Org Articles","description":"Get articles from a Dev.to organization.","operationId":"get_org_articles_v1_devto_organizations__username__articles_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"username","in":"path","required":true,"schema":{"type":"string","title":"Username"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":30,"title":"Per Page"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/devto/podcast-episodes":{"get":{"tags":["devto"],"summary":"List Podcast Episodes","description":"List Dev.to podcast episodes.","operationId":"list_podcast_episodes_v1_devto_podcast_episodes_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":30,"title":"Per Page"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/wikipedia/search":{"get":{"tags":["wikipedia"],"summary":"Search","description":"Search Wikipedia articles by keyword.","operationId":"search_v1_wikipedia_search_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":300,"description":"Search query","title":"Query"},"description":"Search query"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Wikipedia search results","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"results":[{"title":"Artificial intelligence","snippet":"Artificial intelligence (AI) is the intelligence of machines...","word_count":15382,"timestamp":"2026-03-28T12:34:56Z","page_id":233488}]}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/wikipedia/summary":{"get":{"tags":["wikipedia"],"summary":"Summary","description":"Get a summary of a Wikipedia article.","operationId":"summary_v1_wikipedia_summary_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"title","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"description":"Article title","title":"Title"},"description":"Article title"}],"responses":{"200":{"description":"Wikipedia article summary","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"title":"Artificial intelligence","extract":"Artificial intelligence (AI) is the intelligence of machines or software, as opposed to the intelligence of humans or animals.","description":"Intelligence of machines","thumbnail_url":"https://upload.wikimedia.org/wikipedia/commons/thumb/a/a1/Alan_Turing.jpg/220px-Alan_Turing.jpg","url":"https://en.wikipedia.org/wiki/Artificial_intelligence","last_modified":"2026-03-28T12:34:56Z"}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/wikipedia/page":{"get":{"tags":["wikipedia"],"summary":"Page","description":"Get the full plain-text content of a Wikipedia article.","operationId":"page_v1_wikipedia_page_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"title","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"description":"Article title","title":"Title"},"description":"Article title"}],"responses":{"200":{"description":"Full Wikipedia article content","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"title":"Artificial intelligence","content":"Artificial intelligence (AI) is the intelligence of machines or software...\n\n== History ==\nThe field of AI research was founded at a workshop...","page_id":233488,"url":"https://en.wikipedia.org/wiki/Artificial_intelligence"}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/arxiv/search":{"get":{"tags":["arxiv"],"summary":"Search Papers","description":"Search research papers on ArXiv.","operationId":"search_papers_v1_arxiv_search_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":500,"description":"Search query","title":"Query"},"description":"Search query"},{"name":"start","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Start"}},{"name":"max_results","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Max Results"}},{"name":"sort_by","in":"query","required":false,"schema":{"type":"string","pattern":"^(relevance|lastUpdatedDate|submittedDate)$","default":"relevance","title":"Sort By"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":20,"pattern":"^[a-z\\-]+(\\.[A-Z]{2})?$"},{"type":"null"}],"description":"Category filter (e.g. cs.AI)","title":"Category"},"description":"Category filter (e.g. cs.AI)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/arxiv/paper":{"get":{"tags":["arxiv"],"summary":"Get Paper","description":"Get a specific paper by ArXiv ID.","operationId":"get_paper_v1_arxiv_paper_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":20,"pattern":"^\\d{4}\\.\\d{4,5}(v\\d+)?$","description":"ArXiv paper ID (e.g. 2301.12345)","title":"Id"},"description":"ArXiv paper ID (e.g. 2301.12345)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/search/search":{"get":{"tags":["search"],"summary":"Search","description":"Web search via Tavily.","operationId":"search_v1_search_search_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":400,"description":"Search query","title":"Query"},"description":"Search query"},{"name":"search_depth","in":"query","required":false,"schema":{"type":"string","pattern":"^(basic|advanced)$","description":"Search depth: basic or advanced","default":"basic","title":"Search Depth"},"description":"Search depth: basic or advanced"},{"name":"max_results","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"description":"Maximum number of results","default":5,"title":"Max Results"},"description":"Maximum number of results"},{"name":"include_answer","in":"query","required":false,"schema":{"type":"string","pattern":"^(true|false)$","description":"Include AI-generated answer","default":"true","title":"Include Answer"},"description":"Include AI-generated answer"},{"name":"topic","in":"query","required":false,"schema":{"type":"string","pattern":"^(general|news)$","description":"Search topic","default":"general","title":"Topic"},"description":"Search topic"}],"responses":{"200":{"description":"Web search results","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"query":"AI agent frameworks 2026","answer":"Several AI agent frameworks have emerged in 2026...","results":[{"title":"Top AI Agent Frameworks in 2026","url":"https://example.com/ai-agents","content":"A comprehensive overview of the leading frameworks...","score":0.95}],"response_time":1.23}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/search/extract":{"get":{"tags":["search"],"summary":"Extract","description":"Extract content from URLs via Tavily.","operationId":"extract_v1_search_extract_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"urls","in":"query","required":true,"schema":{"type":"string","minLength":1,"description":"Comma-separated URLs to extract content from","title":"Urls"},"description":"Comma-separated URLs to extract content from"}],"responses":{"200":{"description":"Extracted URL content","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"results":[{"url":"https://example.com/article","raw_content":"<html>...</html>","content":"Extracted text content from the page..."}]}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/weather/current":{"get":{"tags":["weather"],"summary":"Current Weather","description":"Get current weather for a location.","operationId":"current_weather_v1_weather_current_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"city","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100,"pattern":"^[a-zA-Z0-9 ,.\\-]+$"},{"type":"null"}],"description":"City name (e.g. 'London' or 'London,GB')","title":"City"},"description":"City name (e.g. 'London' or 'London,GB')"},{"name":"lat","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":90,"minimum":-90},{"type":"null"}],"description":"Latitude","title":"Lat"},"description":"Latitude"},{"name":"lon","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":180,"minimum":-180},{"type":"null"}],"description":"Longitude","title":"Lon"},"description":"Longitude"},{"name":"units","in":"query","required":false,"schema":{"type":"string","pattern":"^(metric|imperial|standard)$","description":"Units: metric, imperial, or standard","default":"metric","title":"Units"},"description":"Units: metric, imperial, or standard"}],"responses":{"200":{"description":"Current weather conditions","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"location":"London","temperature":15.2,"feels_like":13.8,"humidity":72,"pressure":1012,"wind_speed":4.1,"wind_direction":250,"description":"scattered clouds","icon":"03d","clouds":40,"visibility":10000,"timestamp":1712678400}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/weather/forecast":{"get":{"tags":["weather"],"summary":"Forecast","description":"Get 5-day weather forecast for a location.","operationId":"forecast_v1_weather_forecast_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"city","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100,"pattern":"^[a-zA-Z0-9 ,.\\-]+$"},{"type":"null"}],"description":"City name (e.g. 'London' or 'London,GB')","title":"City"},"description":"City name (e.g. 'London' or 'London,GB')"},{"name":"lat","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":90,"minimum":-90},{"type":"null"}],"description":"Latitude","title":"Lat"},"description":"Latitude"},{"name":"lon","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":180,"minimum":-180},{"type":"null"}],"description":"Longitude","title":"Lon"},"description":"Longitude"},{"name":"units","in":"query","required":false,"schema":{"type":"string","pattern":"^(metric|imperial|standard)$","description":"Units: metric, imperial, or standard","default":"metric","title":"Units"},"description":"Units: metric, imperial, or standard"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":40,"minimum":1,"description":"Number of forecast entries","default":8,"title":"Limit"},"description":"Number of forecast entries"}],"responses":{"200":{"description":"5-day weather forecast","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"forecasts":[{"temperature":14.6,"feels_like":13.1,"humidity":68,"pressure":1013,"wind_speed":3.8,"wind_direction":230,"description":"light rain","icon":"10d","clouds":75,"visibility":8000,"timestamp":1712692800,"forecast_time":"2025-04-10 00:00:00"},{"temperature":12.3,"feels_like":10.9,"humidity":80,"pressure":1010,"wind_speed":5.2,"wind_direction":210,"description":"overcast clouds","icon":"04n","clouds":90,"visibility":10000,"timestamp":1712703600,"forecast_time":"2025-04-10 03:00:00"}]}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/coingecko/price":{"get":{"tags":["coingecko"],"summary":"Get Price","description":"Get simple price for one or more coins.","operationId":"get_price_v1_coingecko_price_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ids","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":5100,"pattern":"^[a-z0-9-]+(,[a-z0-9-]+)*$","description":"Comma-separated coin IDs (e.g. bitcoin,ethereum)","title":"Ids"},"description":"Comma-separated coin IDs (e.g. bitcoin,ethereum)"},{"name":"vs_currencies","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":150,"pattern":"^[a-z]+(,[a-z]+)*$","description":"Comma-separated currencies (e.g. usd,eur)","default":"usd","title":"Vs Currencies"},"description":"Comma-separated currencies (e.g. usd,eur)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/coingecko/coin":{"get":{"tags":["coingecko"],"summary":"Get Coin","description":"Get detailed coin information.","operationId":"get_coin_v1_coingecko_coin_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[a-z0-9-]+$","description":"Coin ID (e.g. bitcoin)","title":"Id"},"description":"Coin ID (e.g. bitcoin)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/coingecko/markets":{"get":{"tags":["coingecko"],"summary":"Get Markets","description":"Get top coins by market cap.","operationId":"get_markets_v1_coingecko_markets_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"vs_currency","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":10,"pattern":"^[a-z]+$","description":"Target currency","default":"usd","title":"Vs Currency"},"description":"Target currency"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":1,"title":"Page"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/coingecko/trending":{"get":{"tags":["coingecko"],"summary":"Get Trending","description":"Get trending coins.","operationId":"get_trending_v1_coingecko_trending_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/stackexchange/search":{"get":{"tags":["stackexchange"],"summary":"Search Questions","description":"Search questions on Stack Exchange.","operationId":"search_questions_v1_stackexchange_search_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":300,"description":"Search query","title":"Query"},"description":"Search query"},{"name":"site","in":"query","required":false,"schema":{"type":"string","maxLength":50,"default":"stackoverflow","title":"Site"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","pattern":"^(relevance|votes|creation|activity)$","default":"relevance","title":"Sort"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":30,"minimum":1,"default":10,"title":"Limit"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"tagged","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Comma-separated tags","title":"Tagged"},"description":"Comma-separated tags"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stackexchange/question":{"get":{"tags":["stackexchange"],"summary":"Get Question","description":"Get a specific question with its body.","operationId":"get_question_v1_stackexchange_question_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"integer","exclusiveMinimum":0,"description":"Question ID","title":"Id"},"description":"Question ID"},{"name":"site","in":"query","required":false,"schema":{"type":"string","maxLength":50,"default":"stackoverflow","title":"Site"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stackexchange/answers":{"get":{"tags":["stackexchange"],"summary":"Get Answers","description":"Get answers for a question.","operationId":"get_answers_v1_stackexchange_answers_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"question_id","in":"query","required":true,"schema":{"type":"integer","exclusiveMinimum":0,"description":"Question ID","title":"Question Id"},"description":"Question ID"},{"name":"site","in":"query","required":false,"schema":{"type":"string","maxLength":50,"default":"stackoverflow","title":"Site"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","pattern":"^(votes|creation|activity)$","default":"votes","title":"Sort"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":30,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/finnhub/quote":{"get":{"tags":["finnhub"],"summary":"Get Quote","description":"Get real-time stock quote from Finnhub.","operationId":"get_quote_v1_finnhub_quote_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":10,"description":"Stock symbol (e.g. AAPL)","title":"Symbol"},"description":"Stock symbol (e.g. AAPL)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/finnhub/profile":{"get":{"tags":["finnhub"],"summary":"Get Profile","description":"Get company profile from Finnhub.","operationId":"get_profile_v1_finnhub_profile_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":10,"description":"Stock symbol","title":"Symbol"},"description":"Stock symbol"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/finnhub/search":{"get":{"tags":["finnhub"],"summary":"Search Symbols","description":"Search for stock symbols on Finnhub.","operationId":"search_symbols_v1_finnhub_search_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":100,"description":"Search query","title":"Query"},"description":"Search query"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/finnhub/news":{"get":{"tags":["finnhub"],"summary":"Get News","description":"Get market or company news from Finnhub. If symbol is provided, returns company news; otherwise market news by category.","operationId":"get_news_v1_finnhub_news_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":10},{"type":"null"}],"description":"Stock symbol for company news","title":"Symbol"},"description":"Stock symbol for company news"},{"name":"category","in":"query","required":false,"schema":{"type":"string","pattern":"^(general|forex|crypto|merger)$","default":"general","title":"Category"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/gnews/top-headlines":{"get":{"tags":["gnews"],"summary":"Top Headlines","description":"Get top headlines from GNews.","operationId":"top_headlines_v1_gnews_top_headlines_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"topic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(breaking-news|world|nation|business|technology|entertainment|sports|science|health)$"},{"type":"null"}],"description":"Topic: breaking-news,world,nation,business,technology,entertainment,sports,science,health","title":"Topic"},"description":"Topic: breaking-news,world,nation,business,technology,entertainment,sports,science,health"},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Country"}},{"name":"lang","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Lang"}},{"name":"max","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Max"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}}],"responses":{"200":{"description":"Top headlines","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"total_articles":10,"articles":[{"title":"AI Agents Reshape Software Development","description":"A new wave of AI-powered tools...","url":"https://example.com/article","image_url":"https://example.com/image.jpg","source":"TechNews","published_at":"2026-04-03T08:00:00Z"}]}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/gnews/search":{"get":{"tags":["gnews"],"summary":"Search News","description":"Search news articles via GNews.","operationId":"search_news_v1_gnews_search_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"description":"Search query","title":"Q"},"description":"Search query"},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Country"}},{"name":"lang","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Lang"}},{"name":"max","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Max"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"sortby","in":"query","required":false,"schema":{"type":"string","pattern":"^(publishedAt|relevance)$","default":"publishedAt","title":"Sortby"}}],"responses":{"200":{"description":"News search results","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"total_articles":42,"articles":[{"title":"AI Agents Reshape Software Development","description":"A new wave of AI-powered tools...","url":"https://example.com/article","source":"TechNews","published_at":"2026-04-03T08:00:00Z"}]}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/youtube/search":{"get":{"tags":["youtube"],"summary":"Search","description":"Search YouTube for videos, channels, or playlists. Costs 100 quota units per call (daily limit: 10,000 units). Check `X-YouTube-Quota-Remaining` response header.","operationId":"search_v1_youtube_search_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"description":"Search query","title":"Q"},"description":"Search query"},{"name":"type","in":"query","required":false,"schema":{"type":"string","pattern":"^(video|channel|playlist)$","default":"video","title":"Type"}},{"name":"order","in":"query","required":false,"schema":{"type":"string","pattern":"^(date|rating|relevance|title|viewCount)$","default":"relevance","title":"Order"}},{"name":"maxResults","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Maxresults"}},{"name":"pageToken","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pagetoken"}}],"responses":{"200":{"description":"YouTube search results (costs 100 quota units)","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"items":[{"kind":"video","video_id":"dQw4w9WgXcQ","title":"Building AI Agents with Python","description":"In this tutorial...","channel_title":"TechChannel","published_at":"2026-04-01T12:00:00Z"}],"next_page_token":"CAUQAA"}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/youtube/videos":{"get":{"tags":["youtube"],"summary":"Get Videos","description":"Get video details by ID(s). Costs 1 quota unit.","operationId":"get_videos_v1_youtube_videos_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":500,"description":"Comma-separated video IDs","title":"Id"},"description":"Comma-separated video IDs"},{"name":"part","in":"query","required":false,"schema":{"type":"string","default":"snippet,statistics","title":"Part"}}],"responses":{"200":{"description":"Video details (costs 1 quota unit)","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"items":[{"id":"dQw4w9WgXcQ","title":"Building AI Agents with Python","description":"In this tutorial...","channel_id":"UC_example","channel_title":"TechChannel","view_count":15000,"like_count":420,"comment_count":87,"published_at":"2026-04-01T12:00:00Z"}]}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/youtube/videos/trending":{"get":{"tags":["youtube"],"summary":"Trending Videos","description":"Get trending videos. Costs 1 quota unit.","operationId":"trending_videos_v1_youtube_videos_trending_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"regionCode","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Regioncode"}},{"name":"categoryId","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Categoryid"}},{"name":"maxResults","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Maxresults"}},{"name":"part","in":"query","required":false,"schema":{"type":"string","default":"snippet,statistics","title":"Part"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/youtube/channels/{channel_id}":{"get":{"tags":["youtube"],"summary":"Get Channel","description":"Get channel details. Costs 1 quota unit.","operationId":"get_channel_v1_youtube_channels__channel_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"channel_id","in":"path","required":true,"schema":{"type":"string","title":"Channel Id"}},{"name":"part","in":"query","required":false,"schema":{"type":"string","default":"snippet,statistics","title":"Part"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/youtube/channels/by-handle/{handle}":{"get":{"tags":["youtube"],"summary":"Get Channel By Handle","description":"Get channel details by handle. Costs 1 quota unit.","operationId":"get_channel_by_handle_v1_youtube_channels_by_handle__handle__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"handle","in":"path","required":true,"schema":{"type":"string","title":"Handle"}},{"name":"part","in":"query","required":false,"schema":{"type":"string","default":"snippet,statistics","title":"Part"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/youtube/playlists":{"get":{"tags":["youtube"],"summary":"Get Playlists","description":"Get playlists for a channel. Costs 1 quota unit.","operationId":"get_playlists_v1_youtube_playlists_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"channelId","in":"query","required":true,"schema":{"type":"string","description":"Channel ID","title":"Channelid"},"description":"Channel ID"},{"name":"maxResults","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Maxresults"}},{"name":"pageToken","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pagetoken"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/youtube/playlists/{playlist_id}/items":{"get":{"tags":["youtube"],"summary":"Get Playlist Items","description":"Get videos in a playlist. Costs 1 quota unit.","operationId":"get_playlist_items_v1_youtube_playlists__playlist_id__items_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"playlist_id","in":"path","required":true,"schema":{"type":"string","title":"Playlist Id"}},{"name":"maxResults","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Maxresults"}},{"name":"pageToken","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pagetoken"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/youtube/videos/{video_id}/comments":{"get":{"tags":["youtube"],"summary":"Get Video Comments","description":"Get top-level comments for a video. Costs 1 quota unit.","operationId":"get_video_comments_v1_youtube_videos__video_id__comments_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"video_id","in":"path","required":true,"schema":{"type":"string","title":"Video Id"}},{"name":"maxResults","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Maxresults"}},{"name":"pageToken","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pagetoken"}},{"name":"order","in":"query","required":false,"schema":{"type":"string","pattern":"^(relevance|time)$","default":"relevance","title":"Order"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/youtube/categories":{"get":{"tags":["youtube"],"summary":"Get Categories","description":"Get video categories. Costs 1 quota unit.","operationId":"get_categories_v1_youtube_categories_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"regionCode","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Regioncode"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/github/repos/{owner}/{repo}":{"get":{"tags":["github"],"summary":"Get Repo","description":"Get repository details.","operationId":"get_repo_v1_github_repos__owner___repo__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"owner","in":"path","required":true,"schema":{"type":"string","title":"Owner"}},{"name":"repo","in":"path","required":true,"schema":{"type":"string","title":"Repo"}}],"responses":{"200":{"description":"Repository details","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"id":12345,"name":"ohita","full_name":"ohita-dev/ohita","description":"Unified API for AI Agents","url":"https://github.com/ohita-dev/ohita","language":"Python","stars":42,"forks":7,"open_issues":3,"default_branch":"main","topics":["api","ai-agents"],"created_at":"2026-03-28T00:00:00Z"}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/github/repos/{owner}/{repo}/contents/{path}":{"get":{"tags":["github"],"summary":"Get Repo Contents","description":"Get file/directory listing in a repository.","operationId":"get_repo_contents_v1_github_repos__owner___repo__contents__path__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"owner","in":"path","required":true,"schema":{"type":"string","title":"Owner"}},{"name":"repo","in":"path","required":true,"schema":{"type":"string","title":"Repo"}},{"name":"path","in":"path","required":true,"schema":{"type":"string","title":"Path"}},{"name":"ref","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ref"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/github/repos/{owner}/{repo}/readme":{"get":{"tags":["github"],"summary":"Get Repo Readme","description":"Get rendered README for a repository.","operationId":"get_repo_readme_v1_github_repos__owner___repo__readme_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"owner","in":"path","required":true,"schema":{"type":"string","title":"Owner"}},{"name":"repo","in":"path","required":true,"schema":{"type":"string","title":"Repo"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/github/repos/{owner}/{repo}/issues":{"get":{"tags":["github"],"summary":"List Issues","description":"List issues for a repository.","operationId":"list_issues_v1_github_repos__owner___repo__issues_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"owner","in":"path","required":true,"schema":{"type":"string","title":"Owner"}},{"name":"repo","in":"path","required":true,"schema":{"type":"string","title":"Repo"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","pattern":"^(open|closed|all)$","default":"open","title":"State"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","pattern":"^(created|updated|comments)$","default":"created","title":"Sort"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":30,"title":"Per Page"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}}],"responses":{"200":{"description":"Repository issues","content":{"application/json":{"schema":{},"example":{"ok":true,"data":[{"id":1,"number":42,"title":"Add MCP server support","state":"open","user":"devuser","body":"We should add MCP server support...","labels":["enhancement"],"comments":5,"created_at":"2026-04-01T12:00:00Z"}]}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/github/repos/{owner}/{repo}/issues/{number}":{"get":{"tags":["github"],"summary":"Get Issue","description":"Get a single issue.","operationId":"get_issue_v1_github_repos__owner___repo__issues__number__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"owner","in":"path","required":true,"schema":{"type":"string","title":"Owner"}},{"name":"repo","in":"path","required":true,"schema":{"type":"string","title":"Repo"}},{"name":"number","in":"path","required":true,"schema":{"type":"integer","exclusiveMinimum":0,"title":"Number"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/github/repos/{owner}/{repo}/issues/{number}/comments":{"get":{"tags":["github"],"summary":"Get Issue Comments","description":"Get comments on an issue.","operationId":"get_issue_comments_v1_github_repos__owner___repo__issues__number__comments_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"owner","in":"path","required":true,"schema":{"type":"string","title":"Owner"}},{"name":"repo","in":"path","required":true,"schema":{"type":"string","title":"Repo"}},{"name":"number","in":"path","required":true,"schema":{"type":"integer","exclusiveMinimum":0,"title":"Number"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":30,"title":"Per Page"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/github/repos/{owner}/{repo}/pulls":{"get":{"tags":["github"],"summary":"List Pulls","description":"List pull requests for a repository.","operationId":"list_pulls_v1_github_repos__owner___repo__pulls_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"owner","in":"path","required":true,"schema":{"type":"string","title":"Owner"}},{"name":"repo","in":"path","required":true,"schema":{"type":"string","title":"Repo"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","pattern":"^(open|closed|all)$","default":"open","title":"State"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","pattern":"^(created|updated|popularity|long-running)$","default":"created","title":"Sort"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":30,"title":"Per Page"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/github/repos/{owner}/{repo}/pulls/{number}":{"get":{"tags":["github"],"summary":"Get Pull","description":"Get a single pull request.","operationId":"get_pull_v1_github_repos__owner___repo__pulls__number__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"owner","in":"path","required":true,"schema":{"type":"string","title":"Owner"}},{"name":"repo","in":"path","required":true,"schema":{"type":"string","title":"Repo"}},{"name":"number","in":"path","required":true,"schema":{"type":"integer","exclusiveMinimum":0,"title":"Number"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/github/repos/{owner}/{repo}/commits":{"get":{"tags":["github"],"summary":"List Commits","description":"Get commit history for a repository.","operationId":"list_commits_v1_github_repos__owner___repo__commits_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"owner","in":"path","required":true,"schema":{"type":"string","title":"Owner"}},{"name":"repo","in":"path","required":true,"schema":{"type":"string","title":"Repo"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":30,"title":"Per Page"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/github/repos/{owner}/{repo}/releases":{"get":{"tags":["github"],"summary":"List Releases","description":"Get releases for a repository.","operationId":"list_releases_v1_github_repos__owner___repo__releases_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"owner","in":"path","required":true,"schema":{"type":"string","title":"Owner"}},{"name":"repo","in":"path","required":true,"schema":{"type":"string","title":"Repo"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":30,"title":"Per Page"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/github/search/repos":{"get":{"tags":["github"],"summary":"Search Repos","description":"Search GitHub repositories by query string. Supports sorting by stars, forks, or update time. Subject to 30 req/min search rate limit.","operationId":"search_repos_v1_github_search_repos_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"title":"Q"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","pattern":"^(stars|forks|help-wanted-issues|updated)$","default":"stars","title":"Sort"}},{"name":"order","in":"query","required":false,"schema":{"type":"string","pattern":"^(asc|desc)$","default":"desc","title":"Order"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":30,"title":"Per Page"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}}],"responses":{"200":{"description":"Repository search results","content":{"application/json":{"schema":{},"example":{"ok":true,"data":{"total_count":1,"items":[{"id":12345,"name":"ohita","full_name":"ohita-dev/ohita","description":"Unified API for AI Agents","stars":42,"language":"Python"}]}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"example":{"ok":false,"error":{"code":"AUTH_INVALID","message":"Invalid API key"}}}}},"422":{"description":"Validation error","content":{"application/json":{"example":{"ok":false,"error":{"code":"VALIDATION_ERROR","message":"Validation failed","details":[{"field":"q","message":"field required"}]}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"example":{"ok":false,"error":{"code":"RATE_LIMITED","message":"Per-user rate limit exceeded","retry_after":42}}}}},"503":{"description":"Provider unavailable (stale cache may be returned with `X-Ohita-Stale: true` header)","content":{"application/json":{"example":{"ok":false,"error":{"code":"PROVIDER_UNAVAILABLE","message":"Reddit API is currently unavailable"}}}}}}}},"/v1/github/search/code":{"get":{"tags":["github"],"summary":"Search Code","description":"Search code (30/min rate limit).","operationId":"search_code_v1_github_search_code_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"title":"Q"}},{"name":"order","in":"query","required":false,"schema":{"type":"string","pattern":"^(asc|desc)$","default":"desc","title":"Order"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":30,"title":"Per Page"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/github/users/{username}":{"get":{"tags":["github"],"summary":"Get User","description":"Get user profile.","operationId":"get_user_v1_github_users__username__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"username","in":"path","required":true,"schema":{"type":"string","title":"Username"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/github/users/{username}/repos":{"get":{"tags":["github"],"summary":"Get User Repos","description":"Get user's public repositories.","operationId":"get_user_repos_v1_github_users__username__repos_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"username","in":"path","required":true,"schema":{"type":"string","title":"Username"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","pattern":"^(created|updated|pushed|full_name)$","default":"updated","title":"Sort"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":30,"title":"Per Page"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/github/trending":{"get":{"tags":["github"],"summary":"Trending","description":"Get trending repositories.","operationId":"trending_v1_github_trending_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"language","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"}},{"name":"since","in":"query","required":false,"schema":{"type":"string","pattern":"^(daily|weekly|monthly)$","default":"daily","title":"Since"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AddCredentialRequest":{"properties":{"credentials":{"additionalProperties":true,"type":"object","title":"Credentials","description":"Provider-specific credential fields. For api_key providers: {\"api_key\": \"...\"}. For GitHub: {\"personal_access_token\": \"...\"}."}},"type":"object","required":["credentials"],"title":"AddCredentialRequest","description":"Credential data to store for a provider.","examples":[{"credentials":{"api_key":"AIzaSy..."}}]},"CreateKeyRequest":{"properties":{"label":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Label","description":"Optional label (e.g. 'my-agent')"}},"type":"object","title":"CreateKeyRequest","description":"Request body for API key creation.","examples":[{"label":"my-agent"}]},"CreateKeyResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","description":"Always `true`","default":true},"data":{"$ref":"#/components/schemas/KeyData"}},"type":"object","required":["data"],"title":"CreateKeyResponse","description":"Returned after creating an API key.","examples":[{"data":{"created_at":"2026-04-03T12:00:00Z","id":1,"is_active":true,"key":"ok_live_abc123def456...","label":"my-agent"},"ok":true}]},"CreateSubscriptionRequest":{"properties":{"tier":{"type":"string","pattern":"^(pro|scale)$","title":"Tier","description":"Target tier: 'pro' or 'scale'"}},"type":"object","required":["tier"],"title":"CreateSubscriptionRequest","description":"Request body for creating or upgrading a subscription."},"CredentialInfo":{"properties":{"provider":{"type":"string","title":"Provider"},"credential_type":{"type":"string","title":"Credential Type"},"status":{"type":"string","title":"Status","description":"active, expired, revoked, or error"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"last_validated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Validated At"},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error"}},"type":"object","required":["provider","credential_type","status","created_at","updated_at"],"title":"CredentialInfo","description":"Public (non-secret) view of a stored credential."},"CredentialInfoResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"data":{"$ref":"#/components/schemas/CredentialInfo"}},"type":"object","required":["data"],"title":"CredentialInfoResponse"},"CredentialListResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"data":{"items":{"$ref":"#/components/schemas/CredentialInfo"},"type":"array","title":"Data"}},"type":"object","required":["data"],"title":"CredentialListResponse"},"CredentialTestResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"data":{"additionalProperties":true,"type":"object","title":"Data","description":"Test result with 'valid' boolean and optional 'detail'"}},"type":"object","required":["data"],"title":"CredentialTestResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"InitiatePaymentRequest":{"properties":{"tier":{"type":"string","pattern":"^(pro|scale)$","title":"Tier","description":"Target tier: 'pro' or 'scale'"}},"type":"object","required":["tier"],"title":"InitiatePaymentRequest","description":"Request body for initiating a BTC payment."},"InitiatePaymentResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"data":{"$ref":"#/components/schemas/PaymentData"}},"type":"object","required":["data"],"title":"InitiatePaymentResponse","description":"Response after initiating a payment."},"KeyData":{"properties":{"id":{"type":"integer","title":"Id","description":"Key ID (use for revocation)"},"key":{"type":"string","title":"Key","description":"API key value (prefixed `ok_live_`). Store securely."},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label","description":"Optional human-readable label"},"is_active":{"type":"boolean","title":"Is Active","description":"Whether the key is active"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Key creation timestamp (UTC)"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At","description":"Last time this key was used"}},"type":"object","required":["id","key","is_active","created_at"],"title":"KeyData","description":"A single API key record."},"KeyListResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","description":"Always `true`","default":true},"data":{"items":{"$ref":"#/components/schemas/KeyData"},"type":"array","title":"Data"}},"type":"object","required":["data"],"title":"KeyListResponse","description":"List of all API keys for the authenticated user."},"LogEntry":{"properties":{"provider":{"type":"string","title":"Provider","description":"Provider name (e.g. `github`, `reddit`)"},"action":{"type":"string","title":"Action","description":"Action or endpoint called (e.g. `repo_details`)"},"status_code":{"type":"integer","title":"Status Code","description":"HTTP status code returned by the provider request"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"When the request was made (UTC)"},"response_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Response Ms","description":"Round-trip response time in milliseconds"}},"type":"object","required":["provider","action","status_code","timestamp"],"title":"LogEntry","description":"A single API usage log row."},"LoginRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email","description":"Account email address"},"password":{"type":"string","maxLength":128,"title":"Password","description":"Account password"}},"type":"object","required":["email","password"],"title":"LoginRequest","description":"Authenticate and receive a JWT."},"LogsResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","description":"Always `true` for successful responses","default":true},"data":{"items":{"$ref":"#/components/schemas/LogEntry"},"type":"array","title":"Data"}},"type":"object","required":["data"],"title":"LogsResponse","description":"Response envelope for the logs endpoint.","examples":[{"data":[{"action":"repo_details","provider":"github","response_ms":120,"status_code":200,"timestamp":"2026-04-01T12:00:00"}],"ok":true}]},"PaymentData":{"properties":{"order_id":{"type":"integer","title":"Order Id"},"tier":{"type":"string","title":"Tier"},"amount_usd":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Amount Usd"},"btc_address":{"type":"string","title":"Btc Address"},"btc_amount_satoshi":{"type":"integer","title":"Btc Amount Satoshi"},"btc_price_usd":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Btc Price Usd"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"}},"type":"object","required":["order_id","tier","amount_usd","btc_address","btc_amount_satoshi","btc_price_usd","status","created_at","expires_at"],"title":"PaymentData","description":"Payment order details returned to the client."},"PaymentStatusData":{"properties":{"order_id":{"type":"integer","title":"Order Id"},"tier":{"type":"string","title":"Tier"},"amount_usd":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Amount Usd"},"btc_address":{"type":"string","title":"Btc Address"},"btc_amount_satoshi":{"type":"integer","title":"Btc Amount Satoshi"},"status":{"type":"string","title":"Status"},"txid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Txid"},"confirmed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Confirmed At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"}},"type":"object","required":["order_id","tier","amount_usd","btc_address","btc_amount_satoshi","status","created_at","expires_at"],"title":"PaymentStatusData","description":"Payment status details."},"PaymentStatusResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"data":{"$ref":"#/components/schemas/PaymentStatusData"}},"type":"object","required":["data"],"title":"PaymentStatusResponse","description":"Response for payment status check."},"PostMessageBody":{"properties":{"channel":{"type":"string","title":"Channel","description":"Channel ID to post to (e.g. C01ABCDEF23)"},"text":{"type":"string","maxLength":40000,"minLength":1,"title":"Text","description":"Message text (supports Slack mrkdwn)"}},"type":"object","required":["channel","text"],"title":"PostMessageBody"},"RedeemCouponRequest":{"properties":{"code":{"type":"string","maxLength":100,"minLength":1,"title":"Code","description":"The coupon code to redeem"}},"type":"object","required":["code"],"title":"RedeemCouponRequest","description":"Request body for redeeming a coupon code."},"SignupData":{"properties":{"email":{"type":"string","title":"Email","description":"Registered email address"},"token":{"type":"string","title":"Token","description":"JWT access token (use to create API keys)"}},"type":"object","required":["email","token"],"title":"SignupData"},"SignupRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email","description":"Account email address"},"password":{"type":"string","maxLength":128,"minLength":8,"title":"Password","description":"Password (8-128 characters)"}},"type":"object","required":["email","password"],"title":"SignupRequest","description":"Create a new Ohita account.","examples":[{"email":"agent@example.com","password":"s3cure-p4ss!"}]},"SignupResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","description":"Always `true`","default":true},"data":{"$ref":"#/components/schemas/SignupData"}},"type":"object","required":["data"],"title":"SignupResponse","description":"Returned after successful signup.","examples":[{"data":{"email":"agent@example.com","token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."},"ok":true}]},"SubmissionData":{"properties":{"id":{"type":"integer","title":"Id"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"repo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Repo Url"},"demo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Demo Url"},"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Url"},"team_members":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Members"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","title","description","created_at","updated_at"],"title":"SubmissionData","description":"A single hackathon submission record."},"SubmissionResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"data":{"anyOf":[{"$ref":"#/components/schemas/SubmissionData"},{"type":"null"}]}},"type":"object","title":"SubmissionResponse"},"SubmitRequest":{"properties":{"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title","description":"Project title"},"description":{"type":"string","maxLength":5000,"minLength":10,"title":"Description","description":"What does your agent do?"},"repo_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Repo Url","description":"Repository URL"},"demo_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Demo Url","description":"Live demo URL"},"video_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Video Url","description":"Video walkthrough URL"},"team_members":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Team Members","description":"Team member names (comma-separated)"}},"type":"object","required":["title","description"],"title":"SubmitRequest","description":"Request body for hackathon submission."},"SubscriptionData":{"properties":{"id":{"type":"integer","title":"Id"},"tier":{"type":"string","title":"Tier"},"status":{"type":"string","title":"Status","description":"active | cancel_pending | canceled"},"current_period_start":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Current Period Start"},"current_period_end":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Current Period End"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","tier","status","created_at","updated_at"],"title":"SubscriptionData","description":"Subscription details."},"SubscriptionResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true},"data":{"$ref":"#/components/schemas/SubscriptionData"}},"type":"object","required":["data"],"title":"SubscriptionResponse","description":"Single subscription response."},"SuccessResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","description":"Always `true` for successful responses","default":true},"data":{"title":"Data","description":"Response payload (shape varies by endpoint)"}},"type":"object","title":"SuccessResponse","description":"Standard success envelope returned by all Ohita endpoints.","examples":[{"data":{"message":"Operation completed"},"ok":true}]},"TokenData":{"properties":{"token":{"type":"string","title":"Token","description":"JWT access token"},"expires_in":{"type":"integer","title":"Expires In","description":"Token lifetime in seconds"}},"type":"object","required":["token","expires_in"],"title":"TokenData"},"TokenResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","description":"Always `true`","default":true},"data":{"$ref":"#/components/schemas/TokenData"}},"type":"object","required":["data"],"title":"TokenResponse","description":"Returned after login or token refresh.","examples":[{"data":{"expires_in":3600,"token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."},"ok":true}]},"UsageData":{"properties":{"tier":{"type":"string","title":"Tier","description":"User's subscription tier"},"quota":{"type":"integer","title":"Quota","description":"Monthly request quota for the tier"},"used":{"type":"integer","title":"Used","description":"Requests used this month"},"remaining":{"type":"integer","title":"Remaining","description":"Remaining requests this month (clamped to 0)"},"by_provider":{"additionalProperties":true,"type":"object","title":"By Provider","description":"Request counts broken down by provider (best-effort, DB-based)"},"period_start":{"type":"string","format":"date-time","title":"Period Start","description":"Start of the current billing period (UTC)"}},"type":"object","required":["tier","quota","used","remaining","period_start"],"title":"UsageData","description":"Usage statistics for the current billing period."},"UsageResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","description":"Always `true` for successful responses","default":true},"data":{"$ref":"#/components/schemas/UsageData"}},"type":"object","required":["data"],"title":"UsageResponse","description":"Response envelope for the usage statistics endpoint.","examples":[{"data":{"by_provider":{"github":800,"reddit":400},"period_start":"2026-04-01T00:00:00","quota":50000,"remaining":48800,"tier":"pro","used":1200},"ok":true}]},"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"}}},"tags":[{"name":"Authentication","description":"Sign up, log in, and refresh JWT tokens. Start here to get access."},{"name":"API Keys","description":"Create, list, and revoke persistent API keys (prefixed `ok_live_`). Use these instead of short-lived JWTs for agent workflows."},{"name":"reddit","description":"Search posts, subreddits, comments, and user profiles. **BYOK only** — add your Reddit app credentials via `/v1/credentials/reddit`."},{"name":"twitter","description":"Search tweets, user timelines, and profiles via the X/Twitter API v2. **BYOK only** — add your bearer token via `/v1/credentials/twitter`."},{"name":"slack","description":"List channels, read message history, search messages, list users, and post messages. **BYOK only** — add your Slack token via `/v1/credentials/slack`. Note: `search.messages` requires a user token (xoxp-)."},{"name":"hackernews","description":"Browse top/new/best/ask/show/job stories, fetch items, search via Algolia. No auth required upstream."},{"name":"wikipedia","description":"Search articles, get summaries, and retrieve full page content from Wikipedia. No auth required upstream."},{"name":"github","description":"Repos, issues, PRs, commits, releases, code search, and trending. Read-only via GitHub App."},{"name":"youtube","description":"Search videos, trending, channels, playlists, and comments. Quota-tracked (10 000 units/day)."},{"name":"weather","description":"Current weather and 5-day forecasts via OpenWeatherMap. Rate-limited to 50 req/min."},{"name":"gnews","description":"Top headlines and news search across 60+ countries. Rate-limited to 5 req/min."},{"name":"search","description":"Web search and URL content extraction via Tavily. Returns agent-optimized structured snippets. BYOK recommended (1,000 free req/month). Rate-limited to 30 req/min."},{"name":"coingecko","description":"Crypto prices, coin details, market rankings, and trending coins via CoinGecko. Rate-limited to 25 req/min."},{"name":"arxiv","description":"Search research papers and retrieve paper details from ArXiv. No auth required upstream. Rate-limited to 30 req/min."},{"name":"devto","description":"Articles, users, tags, organizations, and podcast episodes from Dev.to. No auth required upstream."},{"name":"stackexchange","description":"Search questions, get answers, and browse Q&A from Stack Overflow and other Stack Exchange sites. Rate-limited to 30 req/min."},{"name":"brave","description":"Web and news search via Brave Search. **BYOK only** — add your API key via `/v1/credentials/brave`."},{"name":"finnhub","description":"Real-time stock quotes, company profiles, symbol search, and market news via Finnhub. Rate-limited to 50 req/min."},{"name":"Credentials","description":"Bring Your Own Key (BYOK). Store, list, test, and remove your own API credentials for upstream providers."},{"name":"Health","description":"Unauthenticated health check for uptime monitoring."},{"name":"Payments","description":"Initiate BTC payments via Blockonomics and check payment status."},{"name":"Subscriptions","description":"Manage your subscription tier. Create, view, or cancel subscriptions."},{"name":"Coupons","description":"Redeem promotion coupon codes for free subscription upgrades."},{"name":"Logs","description":"View recent API call logs. Available to Pro and Scale tiers only."},{"name":"Usage","description":"Current-month usage statistics: requests used, quota remaining, and breakdown by provider."}]}