openapi: 3.1.0
info:
  title: APRYCO API
  version: '2026-10-18'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-18: 61 operation(s) read from 7 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; APRYCO has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 7
    documentation: 54
    pages-with-code: 4
    pages-read: 7
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-18'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.jojapi.com/studio/management-api.md
  - https://docs.jojapi.com/consumers/agents.md
  - https://docs.jojapi.com/studio/custom-code.md
  - https://docs.jojapi.com/gateway/gateway-ip-addresses.md
  - https://jojapi.com/hub/api/google-web-search
  - https://jojapi.com/hub/api/twitter
  - https://jojapi.com/hub/api/youtube
servers:
- url: https://app.jojapi.com
paths:
  /:
    get:
      operationId: get
      tags:
      - Api
      summary: GET /
      x-source: https://docs.jojapi.com/studio/custom-code.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: javascript
        snippet: "fetch(\"https://www.example.com/\", {\n  headers: {\n    \"x-jojapi-relay-impersonate\": \"chrome\",\n    \"x-jojapi-relay-proxy\"\
          : env.PROXY_URL, //optional\n  },\n})"
  /AutoComplete/Auto:
    get:
      operationId: get_AutoComplete_Auto
      tags:
      - Autocomplete
      summary: Auto Complete
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /Search/Search:
    get:
      operationId: get_Search_Search
      tags:
      - Search
      summary: Search
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /ShortUrl:
    get:
      operationId: get_ShortUrl
      tags:
      - Shorturl
      summary: X (formerly Twitter) API — Docs, Pricing & Free Playground
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /_jojapi/agent/subscribe/pro-monthly:
    post:
      operationId: post_jojapi_agent_subscribe_pro_monthly
      tags:
      - Jojapi
      summary: POST /_jojapi/agent/subscribe/pro-monthly
      x-source: https://docs.jojapi.com/consumers/agents.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: curl -i -X POST https://web-search.jojapi.net/_jojapi/agent/subscribe/pro-monthly
  /_jojapi/agent/topup:
    post:
      operationId: post_jojapi_agent_topup
      tags:
      - Jojapi
      summary: POST /_jojapi/agent/topup
      x-source: https://docs.jojapi.com/consumers/agents.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostJojapiAgentTopupRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -i -X POST https://web-search.jojapi.net/_jojapi/agent/topup  -H ''content-type: application/json''  -d ''{"amount_usd":
          25, "subscribe": [{"api": "web-search"}]}''

          ```'
  /channel/videos:
    post:
      operationId: post_channel_videos
      tags:
      - Channel
      summary: Channel Videos
      x-source: https://jojapi.com/hub/api/youtube
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /email-search/by-username:
    get:
      operationId: get_email_search_by_username
      tags:
      - Email Search
      summary: Email Search (by username)
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /gateway-ips:
    get:
      operationId: get_gateway_ips
      tags:
      - Gateway Ips
      summary: GET /gateway-ips
      x-source: https://docs.jojapi.com/gateway/gateway-ip-addresses.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl https://app.jojapi.com/gateway-ips

          ```'
  /rest/v2/management-token:
    get:
      operationId: get_rest_v2_management_token
      tags:
      - Rest
      summary: GET /rest/v2/management-token
      x-source: https://docs.jojapi.com/studio/management-api.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl https://app.jojapi.com/rest/v2/management-token  -H "Authorization: Bearer jm_…"

          ```'
  /search:
    get:
      operationId: get_search
      tags:
      - Search
      summary: Worker Code
      x-source: https://docs.jojapi.com/studio/custom-code.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /users/{userid}:
    get:
      operationId: get_users_userid
      tags:
      - Users
      summary: GET /users/{userId}
      x-source: https://docs.jojapi.com/studio/custom-code.md
      parameters:
      - name: userid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl http://127.0.0.1:8787/users/42  -H ''x-jojapi-endpoint: GET /users/{id}''  -H ''x-jojapi-params: {"id":"42"}''  -H ''x-jojapi-user-nick:
          alice'' -H ''x-jojapi-plan-type: periodic''

          ```'
  /v1:
    get:
      operationId: get_v1
      tags:
      - Api
      summary: Web Search
      x-source: https://jojapi.com/hub/api/google-web-search
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1.1/Followers/User:
    get:
      operationId: get_v1_1_Followers_User
      tags:
      - V1
      summary: Followers / Light
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1.1/FollowersIds/User:
    get:
      operationId: get_v1_1_FollowersIds_User
      tags:
      - V1
      summary: Followers IDs
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1.1/Following/User:
    get:
      operationId: get_v1_1_Following_User
      tags:
      - V1
      summary: Following / Light
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1.1/FollowingIds/User:
    get:
      operationId: get_v1_1_FollowingIds_User
      tags:
      - V1
      summary: X (formerly Twitter) API — Docs, Pricing & Free Playground
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1.1/Hashflags:
    get:
      operationId: get_v1_1_Hashflags
      tags:
      - V1
      summary: X (formerly Twitter) API — Docs, Pricing & Free Playground
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1.1/Locations/Locations:
    get:
      operationId: get_v1_1_Locations_Locations
      tags:
      - V1
      summary: Locations
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1.1/TranslateProfile/Translate:
    get:
      operationId: get_v1_1_TranslateProfile_Translate
      tags:
      - V1
      summary: X (formerly Twitter) API — Docs, Pricing & Free Playground
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1.1/TranslateTweet/Translate:
    get:
      operationId: get_v1_1_TranslateTweet_Translate
      tags:
      - V1
      summary: Tweet
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1.1/Trends/Trends:
    get:
      operationId: get_v1_1_Trends_Trends
      tags:
      - V1
      summary: Trends
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1.1/Users/Get:
    get:
      operationId: get_v1_1_Users_Get
      tags:
      - V1
      summary: Users
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/auto-complete/Auto:
    get:
      operationId: get_v1_auto_complete_Auto
      tags:
      - Auto Complete
      summary: Auto Complete
      x-source: https://jojapi.com/hub/api/youtube
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/channel/channels/Channel:
    get:
      operationId: get_v1_channel_channels_Channel
      tags:
      - Channel
      summary: Channels
      x-source: https://jojapi.com/hub/api/youtube
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/channel/community/Channel:
    get:
      operationId: get_v1_channel_community_Channel
      tags:
      - Channel
      summary: Community
      x-source: https://jojapi.com/hub/api/youtube
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/channel/details/Channel:
    get:
      operationId: get_v1_channel_details_Channel
      tags:
      - Channel
      summary: Details
      x-source: https://jojapi.com/hub/api/youtube
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/channel/playlists/Channel:
    get:
      operationId: get_v1_channel_playlists_Channel
      tags:
      - Channel
      summary: Playlists
      x-source: https://jojapi.com/hub/api/youtube
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/channel/search/Channel:
    get:
      operationId: get_v1_channel_search_Channel
      tags:
      - Channel
      summary: Search
      x-source: https://jojapi.com/hub/api/youtube
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/channel/videos/Channel:
    get:
      operationId: get_v1_channel_videos_Channel
      tags:
      - Channel
      summary: Videos
      x-source: https://jojapi.com/hub/api/youtube
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/community-post/comments/Community:
    get:
      operationId: get_v1_community_post_comments_Community
      tags:
      - Community Post
      summary: Community Post Comments
      x-source: https://jojapi.com/hub/api/youtube
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/community-post/details/Community:
    get:
      operationId: get_v1_community_post_details_Community
      tags:
      - Community Post
      summary: Community Post Details
      x-source: https://jojapi.com/hub/api/youtube
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/home/Home:
    get:
      operationId: get_v1_home_Home
      tags:
      - Home
      summary: Home
      x-source: https://jojapi.com/hub/api/youtube
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/playlist/details/Playlist:
    get:
      operationId: get_v1_playlist_details_Playlist
      tags:
      - Playlist
      summary: Playlist Details
      x-source: https://jojapi.com/hub/api/youtube
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/playlist/videos/Playlist:
    get:
      operationId: get_v1_playlist_videos_Playlist
      tags:
      - Playlist
      summary: Playlist Videos
      x-source: https://jojapi.com/hub/api/youtube
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/search:
    get:
      operationId: get_v1_search
      tags:
      - Search
      summary: GET /v1/search
      x-source: https://docs.jojapi.com/consumers/agents.md
      parameters:
      - name: q
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: curl -i https://web-search.jojapi.net/v1/search?q=jojapi
  /v1/search/Search:
    get:
      operationId: get_v1_search_Search
      tags:
      - Search
      summary: Search
      x-source: https://jojapi.com/hub/api/youtube
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/video/comments/Video:
    get:
      operationId: get_v1_video_comments_Video
      tags:
      - Video
      summary: Video Comments
      x-source: https://jojapi.com/hub/api/youtube
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/video/details/Video:
    get:
      operationId: get_v1_video_details_Video
      tags:
      - Video
      summary: Details
      x-source: https://jojapi.com/hub/api/youtube
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/video/related-contents/Video:
    get:
      operationId: get_v1_video_related_contents_Video
      tags:
      - Video
      summary: Video Related Contents
      x-source: https://jojapi.com/hub/api/youtube
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/video/streaming-data/Video:
    get:
      operationId: get_v1_video_streaming_data_Video
      tags:
      - Video
      summary: Video Streaming Data (Some videos may be protected.)
      x-source: https://jojapi.com/hub/api/youtube
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/Favoriters/Tweet:
    get:
      operationId: get_v2_Favoriters_Tweet
      tags:
      - Favoriters
      summary: Favoriters
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/Followers/User:
    get:
      operationId: get_v2_Followers_User
      tags:
      - Followers
      summary: Followers
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/Following/User:
    get:
      operationId: get_v2_Following_User
      tags:
      - Following
      summary: Following
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/Likes/User:
    get:
      operationId: get_v2_Likes_User
      tags:
      - Likes
      summary: User Likes
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/ListTimeline:
    get:
      operationId: get_v2_ListTimeline
      tags:
      - Listtimeline
      summary: X (formerly Twitter) API — Docs, Pricing & Free Playground
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/Retweeters/Tweet:
    get:
      operationId: get_v2_Retweeters_Tweet
      tags:
      - Retweeters
      summary: Retweeters
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/Subscriptions:
    get:
      operationId: get_v2_Subscriptions
      tags:
      - Subscriptions
      summary: X (formerly Twitter) API — Docs, Pricing & Free Playground
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/Tweet/Tweet:
    get:
      operationId: get_v2_Tweet_Tweet
      tags:
      - Tweet
      summary: Tweet Detail / Alternative
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/TweetDetail/Tweet:
    get:
      operationId: get_v2_TweetDetail_Tweet
      tags:
      - Tweetdetail
      summary: Tweet Detail & Conversation
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/UserAffiliates/User:
    get:
      operationId: get_v2_UserAffiliates_User
      tags:
      - Useraffiliates
      summary: X (formerly Twitter) API — Docs, Pricing & Free Playground
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/UserByRestId/User:
    get:
      operationId: get_v2_UserByRestId_User
      tags:
      - Userbyrestid
      summary: User By Rest ID
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/UserByScreenName/User:
    get:
      operationId: get_v2_UserByScreenName_User
      tags:
      - Userbyscreenname
      summary: By Screen Name
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/UserHighlights:
    get:
      operationId: get_v2_UserHighlights
      tags:
      - Userhighlights
      summary: X (formerly Twitter) API — Docs, Pricing & Free Playground
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/UserMedia/User:
    get:
      operationId: get_v2_UserMedia_User
      tags:
      - Usermedia
      summary: User Media
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/UserTweets/User:
    get:
      operationId: get_v2_UserTweets_User
      tags:
      - Usertweets
      summary: User Tweets
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/UserTweetsAndReplies/User:
    get:
      operationId: get_v2_UserTweetsAndReplies_User
      tags:
      - Usertweetsandreplies
      summary: User Tweets & Replies
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/UsersByRestIds/Users:
    get:
      operationId: get_v2_UsersByRestIds_Users
      tags:
      - Usersbyrestids
      summary: User By Rest IDs
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/VerifiedFollowers:
    get:
      operationId: get_v2_VerifiedFollowers
      tags:
      - Verifiedfollowers
      summary: User Verified Followers
      x-source: https://jojapi.com/hub/api/twitter
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/trending:
    get:
      operationId: get_v2_trending
      tags:
      - Trending
      summary: Trending
      x-source: https://jojapi.com/hub/api/youtube
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/video-details:
    get:
      operationId: get_v2_video_details
      tags:
      - Video Details
      summary: Video Details (v2)
      x-source: https://jojapi.com/hub/api/youtube
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    PostJojapiAgentTopupRequest:
      type: object
      properties:
        amount_usd:
          type: integer
        subscribe:
          type: array
          items:
            type: object
            properties:
              api:
                type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api
- name: Auto Complete
- name: Autocomplete
- name: Channel
- name: Community Post
- name: Email Search
- name: Favoriters
- name: Followers
- name: Following
- name: Gateway Ips
- name: Home
- name: Jojapi
- name: Likes
- name: Listtimeline
- name: Playlist
- name: Rest
- name: Retweeters
- name: Search
- name: Shorturl
- name: Subscriptions
- name: Trending
- name: Tweet
- name: Tweetdetail
- name: Useraffiliates
- name: Userbyrestid
- name: Userbyscreenname
- name: Userhighlights
- name: Usermedia
- name: Users
- name: Usersbyrestids
- name: Usertweets
- name: Usertweetsandreplies
- name: V1
- name: Verifiedfollowers
- name: Video
- name: Video Details