PDF Generator | StudyFetch API

Overview

The PDF Generator service allows you to create PDF presentations on any topic. This is useful for:

Generating educational presentation slides
Creating topic-specific presentations
Producing multilingual presentations
Building quick presentation outlines

Create PDF Presentation

Generate a new PDF presentation on a specific topic.

JavaScript

import StudyfetchSDK from '@studyfetch/sdk';

const client = new StudyfetchSDK({
  apiKey: 'your-api-key',
  baseURL: 'https://studyfetchapi.com',
});

const pdfResponse = await client.v1.pdfGenerator.create({
  topic: 'Biology Chapter 1 Summary',
  numberOfSlides: 10,
  locale: 'en'
});

console.log('PDF created:', pdfResponse.presentation?._id);
console.log('Success:', pdfResponse.success);

Python

from studyfetch_sdk import StudyfetchSDK

client = StudyfetchSDK(
    api_key="your-api-key",
    base_url="https://studyfetchapi.com",
)

pdf_response = client.v1.pdf_generator.create({
    "topic": "Biology Chapter 1 Summary",
    "number_of_slides": 10,
    "locale": "en"
})

print(f"PDF created: {pdf_response.presentation._id if pdf_response.presentation else 'None'}")
print(f"Success: {pdf_response.success}")

Java

import com.studyfetch.javasdk.client.StudyfetchSdkClient;
import com.studyfetch.javasdk.client.okhttp.StudyfetchSdkOkHttpClient;
import com.studyfetch.javasdk.models.v1.pdfgenerator.PdfGeneratorCreateParams;
import com.studyfetch.javasdk.models.v1.pdfgenerator.PdfGeneratorCreateResponse;
import java.util.List;

StudyfetchSdkClient client = StudyfetchSdkOkHttpClient.builder()
    .apiKey(System.getenv("STUDYFETCH_API_KEY"))
    .baseUrl("https://studyfetchapi.com")
    .build();

PdfGeneratorCreateParams params = PdfGeneratorCreateParams.builder()
    .topic("Biology Chapter 1 Summary")
    .numberOfSlides(10)
    .locale("en")
    .build();

PdfGeneratorCreateResponse pdfResponse = client.v1().pdfGenerator().create(params);

System.out.println("PDF created: " + pdfResponse.presentation()._id());
System.out.println("Success: " + pdfResponse.success());

using StudyfetchSDK;
using StudyfetchSDK.Models.V1.PdfGenerator;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;

public class CreatePdfPresentation
{
    public static async Task CreatePdf()
    {
        var client = new StudyfetchSDKClient()
        {
            APIKey = Environment.GetEnvironmentVariable("STUDYFETCH_API_KEY"),
            BaseUrl = new Uri("https://studyfetchapi.com")
        };

        var pdfResponse = await client.V1.PdfGenerator.Create(new()
        {
            Topic = "Biology Chapter 1 Summary",
            NumberOfSlides = 10,
            Locale = "en"
        });

        Console.WriteLine($"PDF created: {pdfResponse.Presentation?._ID}");
        Console.WriteLine($"Success: {pdfResponse.Success}");
    }
}

Get All PDFs

Retrieve a list of all generated PDFs.

JavaScript

const pdfs = await client.v1.pdfGenerator.getAll();

pdfs.forEach(pdf => {
  console.log(`${pdf.topic} - ${pdf.createdAt}`);
  console.log(`ID: ${pdf._id}`);
  console.log(`Slides: ${pdf.numberOfSlides}`);
});

Python

pdfs = client.v1.pdf_generator.get_all()

for pdf in pdfs:
    print(f"{pdf.topic} - {pdf.created_at}")
    print(f"ID: {pdf._id}")
    print(f"Slides: {pdf.number_of_slides}")

Java

import com.studyfetch.javasdk.models.v1.pdfgenerator.PdfResponse;
import java.util.List;

List<PdfResponse> pdfs = client.v1().pdfGenerator().getAll();

for (PdfResponse pdf : pdfs) {
    System.out.println(pdf.topic() + " - " + pdf.createdAt());
    System.out.println("ID: " + pdf._id());
    System.out.println("Slides: " + pdf.numberOfSlides());
}

using StudyfetchSDK;
using StudyfetchSDK.Models.V1.PdfGenerator;
using StudyfetchSDK.Models.V1.PdfGenerator.Get;
using System;
using System.Threading.Tasks;

public class GetAllPdfs
{
    public static async Task GetAll()
    {
        var client = new StudyfetchSDKClient()
        {
            APIKey = Environment.GetEnvironmentVariable("STUDYFETCH_API_KEY"),
            BaseUrl = new Uri("https://studyfetchapi.com")
        };

        var pdfs = await client.V1.PdfGenerator.GetAll();

        foreach (var pdf in pdfs)
        {
            Console.WriteLine($"{pdf.Topic} - {pdf.CreatedAt}");
            Console.WriteLine($"ID: {pdf._ID}");
            Console.WriteLine($"Slides: {pdf.NumberOfSlides}");
        }
    }
}

Get PDF by ID

Retrieve details of a specific PDF presentation.

JavaScript

const pdfId = 'pdf_123abc';
const pdf = await client.v1.pdfGenerator.getById({
  id: pdfId
});

console.log('Topic:', pdf.topic);
console.log('Created:', pdf.createdAt);
console.log('ID:', pdf._id);
console.log('Slides:', pdf.numberOfSlides);
console.log('Locale:', pdf.locale);

Python

pdf_id = "pdf_123abc"
pdf = client.v1.pdf_generator.get_by_id({
    "id": pdf_id
})

print(f"Topic: {pdf.topic}")
print(f"Created: {pdf.created_at}")
print(f"ID: {pdf._id}")
print(f"Slides: {pdf.number_of_slides}")
print(f"Locale: {pdf.locale}")

Java

import com.studyfetch.javasdk.models.v1.pdfgenerator.PdfGeneratorGetByIdParams;
import com.studyfetch.javasdk.models.v1.pdfgenerator.PdfResponse;

String pdfId = "pdf_123abc";
PdfGeneratorGetByIdParams params = PdfGeneratorGetByIdParams.builder()
    .id(pdfId)
    .build();

PdfResponse pdf = client.v1().pdfGenerator().getById(params);

System.out.println("Topic: " + pdf.topic());
System.out.println("Created: " + pdf.createdAt());
System.out.println("ID: " + pdf._id());
System.out.println("Slides: " + pdf.numberOfSlides());
System.out.println("Locale: " + pdf.locale());

using StudyfetchSDK;
using StudyfetchSDK.Models.V1.PdfGenerator;
using StudyfetchSDK.Models.V1.PdfGenerator.Get;
using System;
using System.Threading.Tasks;

public class GetPdfById
{
    public static async Task GetById()
    {
        var client = new StudyfetchSDKClient()
        {
            APIKey = Environment.GetEnvironmentVariable("STUDYFETCH_API_KEY"),
            BaseUrl = new Uri("https://studyfetchapi.com")
        };

        string pdfId = "pdf_123abc";
        var pdf = await client.V1.PdfGenerator.GetByID(new()
        {
            ID = pdfId
        });

        Console.WriteLine($"Topic: {pdf.Topic}");
        Console.WriteLine($"Created: {pdf.CreatedAt}");
        Console.WriteLine($"ID: {pdf._ID}");
        Console.WriteLine($"Slides: {pdf.NumberOfSlides}");
        Console.WriteLine($"Locale: {pdf.Locale}");
    }
}

Delete PDF

Delete a PDF presentation.

JavaScript

const pdfId = 'pdf_123abc';
const response = await client.v1.pdfGenerator.delete({
  id: pdfId
});

console.log('PDF deleted:', response.success);

Python

pdf_id = "pdf_123abc"
response = client.v1.pdf_generator.delete({
    "id": pdf_id
})

print(f"PDF deleted: {response.success}")

Java

import com.studyfetch.javasdk.models.v1.pdfgenerator.PdfGeneratorDeleteParams;
import com.studyfetch.javasdk.models.v1.pdfgenerator.PdfGeneratorDeleteResponse;

String pdfId = "pdf_123abc";
PdfGeneratorDeleteParams params = PdfGeneratorDeleteParams.builder()
    .id(pdfId)
    .build();

PdfGeneratorDeleteResponse response = client.v1().pdfGenerator().delete(params);

System.out.println("PDF deleted: " + response.success());

using StudyfetchSDK;
using StudyfetchSDK.Models.V1.PdfGenerator;
using System;
using System.Threading.Tasks;

public class DeletePdf
{
    public static async Task Delete()
    {
        var client = new StudyfetchSDKClient()
        {
            APIKey = Environment.GetEnvironmentVariable("STUDYFETCH_API_KEY"),
            BaseUrl = new Uri("https://studyfetchapi.com")
        };

        string pdfId = "pdf_123abc";
        var response = await client.V1.PdfGenerator.Delete(new()
        {
            ID = pdfId
        });

        Console.WriteLine($"PDF deleted: {response.Success}");
    }
}

Complete Example

Here's a complete example that creates a PDF presentation and retrieves its details:

JavaScript

import StudyfetchSDK from '@studyfetch/sdk';
import fs from 'fs';
import https from 'https';

async function createAndCheckPdf() {
  const client = new StudyfetchSDK({
    apiKey: process.env.STUDYFETCH_API_KEY,
    baseURL: 'https://studyfetchapi.com',
  });

  // 1. Create PDF presentation
  const pdfResponse = await client.v1.pdfGenerator.create({
    topic: 'Complete Biology Study Guide',
    numberOfSlides: 15,
    locale: 'en'
  });

  console.log('PDF created:', pdfResponse.presentation?._id);
  console.log('Success:', pdfResponse.success);

  // 2. Check the created presentation
  if (pdfResponse.presentation) {
    const pdf = await client.v1.pdfGenerator.getById({ 
      id: pdfResponse.presentation._id 
    });
    
    console.log('Presentation details:');
    console.log('- Topic:', pdf.topic);
    console.log('- Slides:', pdf.numberOfSlides);
    console.log('- Locale:', pdf.locale);
  }
}

createAndCheckPdf();

Python

import time
import requests
from studyfetch_sdk import StudyfetchSDK

def create_and_check_pdf():
    client = StudyfetchSDK(
        api_key=os.environ.get("STUDYFETCH_API_KEY"),
        base_url="https://studyfetchapi.com",
    )

    # 1. Create PDF presentation
    pdf_response = client.v1.pdf_generator.create({
        "topic": "Complete Biology Study Guide",
        "number_of_slides": 15,
        "locale": "en"
    })

    print(f"PDF created: {pdf_response.id}")

    # 2. Wait for processing to complete
    pdf = client.v1.pdf_generator.get_by_id({"id": pdf_response.id})
    while pdf.status == "processing":
        time.sleep(2)
        pdf = client.v1.pdf_generator.get_by_id({"id": pdf_response.id})

    if pdf.status == "completed":
        print(f"PDF ready for download: {pdf.download_url}")
        
        # 3. Download the PDF
        response = requests.get(pdf.download_url)
        with open("study-guide.pdf", "wb") as f:
            f.write(response.content)
        print("PDF downloaded successfully")
    else:
        print("PDF generation failed")

create_and_check_pdf()

Java

import com.studyfetch.javasdk.client.StudyfetchSdkClient;
import com.studyfetch.javasdk.client.okhttp.StudyfetchSdkOkHttpClient;
import com.studyfetch.javasdk.models.v1.pdfgenerator.*;
import java.io.*;
import java.net.URL;
import java.nio.file.*;
import java.util.List;

public class CreateAndCheckPdf {
    public static void main(String[] args) throws Exception {
        StudyfetchSdkClient client = StudyfetchSdkOkHttpClient.builder()
            .apiKey(System.getenv("STUDYFETCH_API_KEY"))
            .baseUrl("https://studyfetchapi.com")
            .build();

        // 1. Create PDF presentation
        PdfGeneratorCreateParams createParams = PdfGeneratorCreateParams.builder()
            .topic("Complete Biology Study Guide")
            .numberOfSlides(15)
            .locale("en")
            .build();

        PdfGeneratorCreateResponse pdfResponse = client.v1().pdfGenerator().create(createParams);
        System.out.println("PDF created: " + pdfResponse.id());

        // 2. Wait for processing to complete
        PdfResponse pdf = client.v1().pdfGenerator().getById(
            PdfGeneratorGetByIdParams.builder().id(pdfResponse.id()).build()
        );
        
        while ("processing".equals(pdf.status())) {
            Thread.sleep(2000);
            pdf = client.v1().pdfGenerator().getById(
                PdfGeneratorGetByIdParams.builder().id(pdfResponse.id()).build()
            );
        }

        if ("completed".equals(pdf.status())) {
            System.out.println("PDF ready for download: " + pdf.downloadUrl());
            
            // 3. Download the PDF
            try (InputStream in = new URL(pdf.downloadUrl()).openStream()) {
                Files.copy(in, Paths.get("study-guide.pdf"), 
                    StandardCopyOption.REPLACE_EXISTING);
            }
            System.out.println("PDF downloaded successfully");
        } else {
            System.err.println("PDF generation failed");
        }
    }
}

using StudyfetchSDK;
using StudyfetchSDK.Models.V1.PdfGenerator;
using StudyfetchSDK.Models.V1.PdfGenerator.Get;
using System;
using System.Collections.Generic;
using System.IO;
using System.Net.Http;
using System.Threading;
using System.Threading.Tasks;

public class CreateAndCheckPdf
{
    public static async Task Main()
    {
        var client = new StudyfetchSDKClient()
        {
            APIKey = Environment.GetEnvironmentVariable("STUDYFETCH_API_KEY"),
            BaseUrl = new Uri("https://studyfetchapi.com")
        };

        // 1. Create PDF presentation
        var pdfResponse = await client.V1.PdfGenerator.Create(new()
        {
            Topic = "Complete Biology Study Guide",
            NumberOfSlides = 15,
            Locale = "en"
        });

        Console.WriteLine($"PDF created: {pdfResponse.Presentation?._ID}");

        // 2. Check the created presentation
        if (pdfResponse.Presentation != null)
        {
            var pdf = await client.V1.PdfGenerator.GetByID(new() { 
                ID = pdfResponse.Presentation._ID 
            });
            
            Console.WriteLine("Presentation details:");
            Console.WriteLine($"- Topic: {pdf.Topic}");
            Console.WriteLine($"- Slides: {pdf.NumberOfSlides}");
            Console.WriteLine($"- Locale: {pdf.Locale}");
        }
    }
}