naftiko: 1.0.0-alpha2
info:
  label: PDF.co Conversion API
  description: PDF.co Conversion API. To-PDF, From-PDF, and Excel conversion endpoints. Self-contained Naftiko
    capability over the PDF.co Conversion business surface.
  tags:
  - PDF.co
  - Conversion
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    PDFCO_API_KEY: PDFCO_API_KEY
capability:
  consumes:
  - type: http
    namespace: conversion
    baseUri: https://api.pdf.co
    description: PDF.co Conversion business capability.
    resources:
    - name: pdf-to-csv
      path: /v1/pdf/convert/to/csv
      operations:
      - {name: pdfToCsv, method: POST, description: PDF to CSV with layout-preserved tables, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: pdf-to-json2
      path: /v1/pdf/convert/to/json2
      operations:
      - {name: pdfToJson, method: POST, description: PDF to JSON, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: pdf-to-json-meta
      path: /v1/pdf/convert/to/json-meta
      operations:
      - {name: pdfToJsonMeta, method: POST, description: PDF to JSON with metadata, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: pdf-to-text
      path: /v1/pdf/convert/to/text
      operations:
      - {name: pdfToText, method: POST, description: PDF to text with layout, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: pdf-to-text-simple
      path: /v1/pdf/convert/to/text-simple
      operations:
      - {name: pdfToTextSimple, method: POST, description: Fast text extraction without OCR, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: pdf-to-xls
      path: /v1/pdf/convert/to/xls
      operations:
      - {name: pdfToXls, method: POST, description: PDF to XLS, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: pdf-to-xlsx
      path: /v1/pdf/convert/to/xlsx
      operations:
      - {name: pdfToXlsx, method: POST, description: PDF to XLSX, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: pdf-to-xml
      path: /v1/pdf/convert/to/xml
      operations:
      - {name: pdfToXml, method: POST, description: PDF to XML, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: pdf-to-html
      path: /v1/pdf/convert/to/html
      operations:
      - {name: pdfToHtml, method: POST, description: PDF to HTML, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: pdf-to-jpg
      path: /v1/pdf/convert/to/jpg
      operations:
      - {name: pdfToJpg, method: POST, description: PDF to JPG images, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: pdf-to-png
      path: /v1/pdf/convert/to/png
      operations:
      - {name: pdfToPng, method: POST, description: PDF to PNG images, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: pdf-to-tiff
      path: /v1/pdf/convert/to/tiff
      operations:
      - {name: pdfToTiff, method: POST, description: PDF to TIFF images, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: pdf-to-webp
      path: /v1/pdf/convert/to/webp
      operations:
      - {name: pdfToWebp, method: POST, description: PDF to WebP images, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: pdf-from-csv
      path: /v1/pdf/convert/from/csv
      operations:
      - {name: pdfFromCsv, method: POST, description: CSV/XLS to PDF, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: pdf-from-doc
      path: /v1/pdf/convert/from/doc
      operations:
      - {name: pdfFromDoc, method: POST, description: DOC/DOCX/RTF/TXT to PDF, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: pdf-from-email
      path: /v1/pdf/convert/from/email
      operations:
      - {name: pdfFromEmail, method: POST, description: Email (.msg/.eml) to PDF, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: pdf-from-html
      path: /v1/pdf/convert/from/html
      operations:
      - {name: pdfFromHtml, method: POST, description: HTML to PDF, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: pdf-from-image
      path: /v1/pdf/convert/from/image
      operations:
      - {name: pdfFromImage, method: POST, description: Images to PDF, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: pdf-from-url
      path: /v1/pdf/convert/from/url
      operations:
      - {name: pdfFromUrl, method: POST, description: URL to PDF, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: xls-to-csv
      path: /v1/xls/convert/to/csv
      operations:
      - {name: xlsToCsv, method: POST, description: Excel to CSV, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: xls-to-json
      path: /v1/xls/convert/to/json
      operations:
      - {name: xlsToJson, method: POST, description: Excel to JSON, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: xls-to-html
      path: /v1/xls/convert/to/html
      operations:
      - {name: xlsToHtml, method: POST, description: Excel to HTML, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: xls-to-txt
      path: /v1/xls/convert/to/txt
      operations:
      - {name: xlsToTxt, method: POST, description: Excel to text, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: xls-to-xml
      path: /v1/xls/convert/to/xml
      operations:
      - {name: xlsToXml, method: POST, description: Excel to XML, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    - name: xls-to-pdf
      path: /v1/xls/convert/to/pdf
      operations:
      - {name: xlsToPdf, method: POST, description: Excel to PDF, outputRawFormat: json, inputParameters: [{name: body, in: body, type: object, required: true}]}
    authentication:
      type: apikey
      key: x-api-key
      value: '{{env.PDFCO_API_KEY}}'
      placement: header