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

• Dynamic API
  • Create a new Narrativ Dynamic Link (SmartLink)
• ClickMate
  • Overview
  • Build a ClickMate Link
  • Query Params
  • URL Encoding
  • Example Code
• Multi-Match Exclusive API
  • Overview
  • URL Encoding
  • Example Requests
  • Example Response
• Merchant Feeds
  • Overview
  • Feed Schema
  • Feed Delivery
• UTM Source Tracking
  • Overview
  • Building a Narrativ Attributed Link
• 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
  • Audit Mode Implementation
  • Active Mode Implementation
  • Active Mode Capabilities: Link Rewrite Options
  • Active Tag Capabilities: Dynamic price and merchant names (Out of Stock optimization)
  • Merchant Checkout Tracking: U1 Parameter Support
• Narrativ Brand Tag
  • What is it?
  • How it Works
  • Implementation
  • Shopify Checkout Code
  • Google Tag Manager Implementation
  • Testing the Brand Tag
• 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
  • Create Links
  • Copy Existing Links
• 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
• How to Use Mobile Link Creation
  • 1. Sign into dashboard.narrativ.com on any mobile browser and paste in your product link
  • 2. Assign the link to an existing story or create a new one
  • 3. Create and copy your link. You’re now ready to paste it into a story on any platform!

Merchandiser How To

• Product Feeds
  • Ingesting Product Feeds
  • Formatting
  • 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!