Narrativ API Developer Documentation

At Narrativ, we transform real content into organic ads that are not impacted by AdBlock. Our goal is to lift publisher revenues from organic content through real-time bidding and machine learning solutions. The Narrativ API allows you to access our technology without having editors create manual links. Create an API key to get started or browse the full documentation below:

API Overview

• API Authentication
  • Creating an API key
  • Using your API key
  • Keeping your account secure
• Sending and Receiving Data
  • Data formats
  • Response fields

Publisher Tools

• SmartLinks
  • Create a new SmartLink
• ClickMate
  • Overview
  • Build a ClickMate Link
  • Query Params
  • URL Encoding
  • Example Code
• Product API
  • Overview
  • URL Encoding
  • Example Requests
  • Example Response
• LinkMate
  • Usage
  • Create and Retrieve Links
• Auctions
  • Usage
  • Run Auction
• AMP
  • Usage
  • AMP Attribute values
• Publisher Events
  • Submit New Publisher Events
• Statistics
  • Get statistics grouped by articles and merchant per day

Javascript Tag

• Javascript Tag Basics
• Narrativ Publisher Tag
  • Functionality
  • Implementation
  • Usage
  • Updating Article Content with Auction Results
• Narrativ Merchant Tag
  • Functionality
  • Implementation
  • Adding Information About Your Checkout Page
  • Adding Information for the Page View Tag
  • Google Tag Manager Walkthrough
• Custom Publisher Tags
  • Getting Started
  • Page Session Tracking
  • Page Impression Events
  • SmartLinks
  • Auctions
  • SmartLink Events
  • Third-Party Event Trackers
  • Product and Advertiser Information

Publisher How To

• How to Download Narrativ Chrome Extension
  • Step 1. Navigate to Chrome Web Store
  • Step 2. Add Extension
  • Step 3. Sign In
• How to Use Narrativ Chrome Extension
  • Step 1. Select a product
  • Step 2. (Optional) Select a channel
  • Step 3. Associate the product link with the story name
  • Step 4. Select Dynamic or Exclusive link
  • Step 5. Create your SmartLink
• SmartLink Naming Conventions
• How to Build a SmartShop
  • Step 1. Sign into the Narrativ Dashboard
  • Step 2. Create a New SmartShop
  • Step 3. Type in a SmartShop name and Edit name
  • Step 4. Choose a format
  • Step 5. Add products to your SmartShop
  • Step 6. Enter product information
  • Step 7. Preview your SmartShop
  • Step 8. Fine tune your SmartShop
  • Step 9. Hit Publish
  • Step 10. Select the code type you want to drop into your CMS
  • Note: Making changes and editing your SmartShop

Merchandiser How To

• Product Feeds
  • Ingesting Product Feeds
  • Send via FTP
  • Send via SFTP

Narrativ Legal

• Privacy Policy
  • What This Policy Covers
  • Information Collection and Use
  • Information Sharing
  • Interest-Based Advertising and Opting Out
  • Reviewing and Updating Information
  • International Information Transfers
  • Security
  • Policy Updates
  • Contact Us

Support

Need additional help? Feel free to reach out with any questions on integration or Narrativ’s content marketing platform!