Senior Technical Writer

PubMatic; New York (NY); On-site; USD 130,000 - 150,000; Full time

Benefits offered by this job

Hybrid work schedule (3 in office / 2?

Comprehensive benefits

Unlimited DTO in the US

In-office catered lunches

Job summary

PubMatic is seeking a Senior Technical Writer to create clear, developer-friendly API documentation that transforms complex specifications into comprehensive guides. This role focuses on API references, integration guides, and code-to-doc workflows using OpenAPI and REST concepts.

You will collaborate with engineering to extract details, produce multi-language code examples (JavaScript, Python, Go), and ensure accuracy and consistency with the company voice.

Qualifications

• 10+ years of technical writing experience.
• Portfolio demonstrating API reference docs and code examples.
• Proficiency with OpenAPI and REST APIs.
• Proficiency with GitHub and markdown-based workflows.
• Strong knowledge of 2–3 programming languages.

Responsibilities

• Create API documentation from OpenAPI specs, including endpoints and code examples.
• Develop SDK documentation guiding installation, configuration and implementation.
• Write integration guides and tutorials with step-by-step workflows.
• Produce how-to guides focused on practical developer workflows.
• Create multi-language code examples (JS, Python, Go, etc.).
• Document webhooks, authentication mechanisms, and best practices.

Skills

API documentation

OpenAPI

REST APIs

GitHub

Markdown

Programming languages

Tools

Swagger/OpenAPI tooling

GitHub workflows

Job description

About the Role

We're seeking a Senior Technical Writer to create clear, accurate, and developer-friendly technical documentation that transforms complex API specifications and code into comprehensive guides. This role bridges engineering and documentation, specializing in API reference documentation, integration guides, and code-to-doc workflows using industry standards like OpenAPI Specification (OAS).

The Senior Technical Writer produces high-quality content deliverables including API reference documentation, SDKs, how-to guides, tutorials, and code examples.

What You'll Do

Content Creation & Deliverables

• Create comprehensive API documentation from OpenAPI Specification files, including endpoint descriptions, parameters, authentication, error handling, and code examples
• Develop SDK documentation that guides developers through library installation, configuration, and implementation
• Write integration guides and tutorials that walk developers through common use cases step-by-step
• Produce how-to guides focused on practical developer workflows and implementation patterns
• Create code examples in multiple languages (JavaScript, Python, Go, etc.) that demonstrate API usage
• Document webhooks, authentication mechanisms, and best practices for API consumption

Technical Competency

• Manage code-to-doc workflows, including parsing and organizing API specifications using tools like Swagger/OpenAPI
• Leverage generative AI tools (ChatGPT, Copilot, Claude, specialized API doc generators) to accelerate initial documentation drafts from code, OpenAPI specs, and code samples
• Evaluate and refine AI-generated content for accuracy, completeness, clarity, and alignment with company voice and standards
• Understand when and how to use AI effectively in documentation workflows-from generating initial reference documentation to creating code examples and tutorials
• Collaborate with engineering teams to extract technical information, clarify undocumented behavior, and ensure accuracy
• Understand API design principles (REST, GraphQL concepts) and communicate them clearly to developers
• Work with version control systems (GitHub) to manage documentation updates alongside code releases
• Implement and test code samples for accuracy and functionality
• Stay current with API documentation best practices and emerging tools in the developer documentation space, including AI-assisted documentation generation

Content Consistency & Quality

• Maintain documentation consistency across API endpoints, SDKs, and guides
• Implement and adhere to documentation style guides for terminology, formatting, and code sample conventions
• Audit existing API documentation for completeness, accuracy, and technical debt
• Contribute to documentation standards and best practices across the organization

Who You Are

Required

• 10+ years of technical writing experience
• Portfolio demonstrating strong API reference documentation and code examples
• Proven experience with OpenAPI Specification and REST APIs
• Proficiency with GitHub and markdown-based documentation workflows
• Strong working knowledge of at least 2-3 programming languages

Preferred

• Experience documenting SDKs or client libraries
• Familiarity with code-to-doc automation tools or processes, including AI-assisted documentation generators
• Portfolio examples showing use of generative AI to accelerate documentation creation
• Experience evaluating and improving AI-generated technical content for accuracy and quality
• Contributions to open-source documentation projects
• Experience with documentation analytics and user feedback integration
• Familiarity with developer relations or developer experience workflows
• Experience with ReadMe, MkDocs, or similar documentation platforms
• Knowledge of prompt engineering techniques for generating quality API documentation and code examples

Additional Information

Return to Office

PubMatic employees throughout the globe have returned to our offices via a hybrid work schedule (3 days "in office" and 2 days "working remotely") that is intended to maximize collaboration, innovation, and productivity among teams and across functions.

Benefits

Our benefits package includes the best of what leading organizations provide such as, paid leave programs, paid holidays, healthcare, dental and vision insurance, disability and life insurance, commuter benefits, physical and financial wellness programs, unlimited DTO in the US (that we actually require you to use!), reimbursement for mobile and fully stocked pantries plus in-office catered lunches 5 days per week.

Diversity and Inclusion

PubMatic is proud to be an equal opportunity employer; we don't just value diversity, we promote and celebrate it. We do not discriminate on the basis of race, religion, color, national origin, gender, sexual orientation, age, marital status, veteran status, or disability status

About PubMatic

PubMatic is one of the world's leading scaled digital advertising platforms, offering more transparent advertising solutions to publishers, media buyers, commerce companies and data owners, allowing them to harness the power and potential of the open internet to drive better business outcomes.

Founded in 2006 with the vision that data-driven decisioning would be the future of digital advertising, we enable content creators to run a more profitable advertising business, which in turn allows them to invest back into the multi-screen and multi-format content that consumers demand.

#LI-HYBRID

Compensation Disclosure

In accordance with applicable law, the below salary range provided is PubMatic's reasonable estimate of the total compensation for this role. New hires and current team members are typically compensated toward the middle of our pay range. The actual amount may vary, based on non-discriminatory factors such as location, experience, knowledge, skills and abilities. In addition to salary PubMatic also offers a bonus and a competitive benefits package.

Total Compensation Range

$130,000-$150,000 USD