swagger: '2.0'
info:
  title: Article Rewriter and Article Extractor API
  version: '1.0'
  contact:
    name: Spinbot Admin
    email: admin@spinbot.net
    url: 'https://spinbot.net'
  description: >-
    Spinbot.net propose a new solution based on high technologies for faster
    article spinner and extractor that you will love to use it. 
  termsOfService: 'https://spinbot.net/terms-and-conditions'
externalDocs:
  url: 'https://spinbot.net/api-documentation'
schemes:
  - https
consumes: []
produces: []
security:
  - key: []
paths:
  /api/acc:
    get:
      summary: Return the user credit information.
      description: Return the user credit information.
      parameters:
        - name: key
          in: query
          required: true
          type: string
          description: Your api key
      operationId: 'getInfo'
      responses:
        '200':
          description: success
          schema: {}
  /api/pretty-spinner:
    post:
      consumes:
        - multipart/form-data
      summary: Human readable auto rewrite your article.
      description: Human readable auto rewrite your article. The response is in JSON format.
      parameters:
        - name: key
          in: formData
          required: true
          type: string
          description: Your spinbot API key
        - name: text
          in: formData
          required: true
          type: string
          description: Input article that need to be rewrited.
        - name: keep
          in: formData
          required: true
          type: string
          description: Keep words/phrases, separated by newline, those remain unchanged during the rewrite process. 
        - name: accuracy
          in: formData
          required: true
          type: string
          description: Rewrite accuracy profile, accepted values are very-low, low, medium, high, very-high
      operationId: 'postPrettySpinner'
      responses:
        default:
          description: Default response
          schema: {}
  /api/spinner:
    post:
      consumes:
        - multipart/form-data
      summary: Rewriting (spinning) your input article.
      description: Rewriting (spinning) you input article. The response is in JSON format.
      parameters:
        - name: key
          in: formData
          required: true
          type: string
          description: Your spinbot API key
        - name: text
          in: formData
          required: true
          type: string
          description: Input article that need to be rewrited.
      operationId: 'postSpinner'
      responses:
        default:
          description: Default response
          schema: {}
  /api/spintax:
    post:
      consumes:
        - multipart/form-data
      summary: Generate Spintax format for the input article
      description: >-
        Generate Spintax format for the input article, so you can rewrite it
        yourself. The response is in JSON format.
      parameters:
        - name: key
          in: formData
          required: true
          type: string
          description: Your spinbot API key
        - name: text
          in: formData
          required: true
          type: string
          description: Input article that need to be rewritten.
        - name: full_mode
          in: formData
          required: false
          type: string
          description: Full mode option.
      operationId: 'postSpintax'
      responses:
        default:
          description: Default response
          schema: {}
  /api/article:
    post:
      consumes:
        - multipart/form-data
      summary: Extracting the main article of the given URL.
      description: >-
        Extracting the main article of the given URL. The response is in JSON
        format.
      parameters:
        - name: key
          in: formData
          required: true
          type: string
          description: Your spinbot API key
        - name: url
          in: formData
          required: true
          type: string
          description: The url of target article
        - name: faster_mode
          in: formData
          required: false
          type: string
          description: >-
            you can set this input value to 1 to skip detecting the size (width
            and height in pixel) of all the images inside the extracted article.
            The response time of your request will be shortened if you set this
            input value to 1.
      operationId: 'postArticle'
      responses:
        default:
          description: Default response
          schema: {}
host: api.spinbot.net
basePath: /
tags:
  - name: article rewriter
    externalDocs:
      url: 'https://spinbot.net/api-documentation'
    description: >-
      Article rewriter (spinner): rewrite your origin article by replacing every
      terms/words to their synonyms. Our program will try its best to detect as
      many words that can be replaced as possible. So that you will never care
      about the plagiarism checkers. 
  - name: article extractor
    externalDocs:
      url: 'https://spinbot.net/api-documentation'
    description: >-
      Article extractor: a lot of techniques and mordern algorithms like machine
      learning are used to detect the main article content in your given url.
      It's an automated tool to scrape and collect articles. It will reduce your
      time to collect data and keywords for you websites to improve their ranks.
securityDefinitions:
  key:
    type: apiKey
    name: key
    in: query
