Mojeek API

openapi: 3.1.0
info:
  title: Mojeek API
  version: '2026-10-27'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-27: 8 operation(s) read from 2 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Mojeek has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 8
    documentation: 0
    pages-with-code: 2
    pages-read: 2
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-27'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://www.mojeek.com/support/api/search/quickstart.html
  - https://www.mojeek.com/support/api/orgse/request_parameters.html
servers:
- url: https://api.mojeek.com
paths:
  /api/orgse/url:
    post:
      operationId: post_api_orgse_url
      tags:
      - Api
      summary: POST /api/orgse/url
      x-source: https://www.mojeek.com/support/api/orgse/request_parameters.html
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl --request POST \"https://www.mojeek.com/api/orgse/url\"  -d \"api_key=API_KEY\"  -d \"url=URL\"  -d \"pubdate=1793104022\"\
          \  -d \"categories=cat1|cat2|cat3\"  -d \"live=1\"\n Add Categories to a URL \n Appends provided categories to the URLs existing categories\
          \ or adds them if none already exist. \n /url/categories \n api_key string \n Your unique api key to retrieve results. \n url string\
          \ \n URL to add categori"
  /api/orgse/url/categories:
    delete:
      operationId: delete_api_orgse_url_categories
      tags:
      - Api
      summary: DELETE /api/orgse/url/categories
      x-source: https://www.mojeek.com/support/api/orgse/request_parameters.html
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl --request DELETE \"https://www.mojeek.com/api/orgse/url/categories\"  -d \"api_key=API_KEY\"  -d \"url=URL\"  -d \"categories=cat1|cat2|cat3\"\
          \n Update the published date of a URL \n Changes the published date of a URL to the new one provided. \n /url/pubdate \n api_key string\
          \ \n Your unique api key to retrieve results. \n url string \n URL to update the published date for. \n pubdate timestamp \n Published\
          \ d"
    patch:
      operationId: patch_api_orgse_url_categories
      tags:
      - Api
      summary: PATCH /api/orgse/url/categories
      x-source: https://www.mojeek.com/support/api/orgse/request_parameters.html
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl --request PATCH \"https://www.mojeek.com/api/orgse/url/categories\"  -d \"api_key=API_KEY\"  -d \"url=URL\"  -d \"categories=cat1|cat2|cat3\"\
          \n Delete Categories from a URL \n Deletes one or more categories from a URL. \n /url/categories \n api_key string \n Your unique api\
          \ key to retrieve results. \n url string \n URL to remove categories from. \n categories string \n Pipe separated list of case-sensitive\
          \ ca"
    post:
      operationId: post_api_orgse_url_categories
      tags:
      - Api
      summary: POST /api/orgse/url/categories
      x-source: https://www.mojeek.com/support/api/orgse/request_parameters.html
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl --request POST \"https://www.mojeek.com/api/orgse/url/categories\"  -d \"api_key=API_KEY\"  -d \"url=URL\"  -d \"categories=cat1|cat2|cat3\"\
          \n Replace URL Categories \n Replaces all existing categories for this URL with the new ones provided. \n /url/categories \n api_key\
          \ string \n Your unique api key to retrieve results. \n url string \n URL to replace the categories for. \n categories string \n Pipe\
          \ separat"
  /api/orgse/url/live:
    patch:
      operationId: patch_api_orgse_url_live
      tags:
      - Api
      summary: PATCH /api/orgse/url/live
      x-source: https://www.mojeek.com/support/api/orgse/request_parameters.html
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl --request PATCH \"https://www.mojeek.com/api/orgse/url/live\"  -d \"api_key=API_KEY\"  -d \"url=URL\"  -d \"live=1\"\n\
          \ Refresh a URL \n This marks a URL to be re-crawled and re-indexed. \n /url/refresh \n api_key string \n Your unique api key to retrieve\
          \ results. \n url string \n URL to re-crawl and re-index. \n Example: "
  /api/orgse/url/pubdate:
    patch:
      operationId: patch_api_orgse_url_pubdate
      tags:
      - Api
      summary: PATCH /api/orgse/url/pubdate
      x-source: https://www.mojeek.com/support/api/orgse/request_parameters.html
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl --request PATCH \"https://www.mojeek.com/api/orgse/url/pubdate\"  -d \"api_key=API_KEY\"  -d \"url=URL\"  -d \"pubdate=1793104022\"\
          \n Update the live status of a URL \n Changes the live status of a URL in order to show/hide it in search results. \n /url/live \n api_key\
          \ string \n Your unique api key to retrieve results. \n url string \n URL to update the live status for. \n live boolean \n Set the\
          \ live status "
  /api/orgse/url/refresh:
    get:
      operationId: get_api_orgse_url_refresh
      tags:
      - Api
      summary: GET /api/orgse/url/refresh
      x-source: https://www.mojeek.com/support/api/orgse/request_parameters.html
      parameters:
      - name: api_key
        in: query
        required: false
        schema:
          type: string
      - name: url
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl \"https://www.mojeek.com/api/orgse/url/refresh?api_key=API_KEY&url=URL\"\n Endpoints on this Page \n Add a URL \n Add Categories\
          \ to a URL \n Replace URL Categories \n Delete Categories from a URL \n Update the published date of a URL \n Update the live status\
          \ of a URL \n Refresh a URL \n Orgse Documentation \n OrgSe \n OrgSe Response Codes \n Related Pages \n Search API \n Web Search API\
          \ \n Search Web Images "
  /search:
    get:
      operationId: get_search
      tags:
      - Search
      summary: GET /search
      x-source: https://www.mojeek.com/support/api/search/quickstart.html
      parameters:
      - name: api_key
        in: query
        required: false
        schema:
          type: string
      - name: fmt
        in: query
        required: false
        schema:
          type: string
      - name: lb
        in: query
        required: false
        schema:
          type: string
      - name: lbb
        in: query
        required: false
        schema:
          type: string
      - name: q
        in: query
        required: false
        schema:
          type: string
      - name: rb
        in: query
        required: false
        schema:
          type: string
      - name: rbb
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl \"https://api.mojeek.com/search?q=mojeek&api_key=YOUR_API_KEY&lb=EN&lbb=100&rb=GB&rbb=10&fmt=json\"\n Next Steps \n To\
          \ learn more about the available query parameters and responses returned by the Mojeek Search API please see the following pages: \n\
          \ Request Parameters \n JSON Response Format \n XML Response Format \n Search API Documentation \n Request Parameters \n Results Scoring\
          \ Parameters \n JSON Re"
tags:
- name: Api
- name: Search
components:
  securitySchemes:
    api_key:
      type: apiKey
      in: query
      name: Authorization
      x-source: https://www.mojeek.com/support/api/search/quickstart.html
security:
- api_key: []