Outbrain supports a number of standard technologies web sites developers.

Please Note

This guide is for web sites developers – Mobile Apps should use Outbrain Native SDKs.

  • All technologies must be used from browsers directly. Use of server-to-server integration of any kind is not supported.
  •  

    JS Widget


     
    Specifications

    • The JS-Widget provides a standard way to displays outbrain recommendations and their UI with a standard JS code snippet. The UI is built and controlled by Outbrain code and back-office tools.

     
    Documentation

    • Please request the instructions from your Outbrain Account Manager.

     

    Web API


    Applicable for

    • Web browsers, in cases where JS-Widget use is not applicable. Please consult with your account manager.

     
    Specifications

    • The Web API (EndPoint API is the product name) provides a way to consume Outbrain recommendations data via HTTP API invocations.
    • The developer is responsible for building the UI elements and building a compliant integration according to the documentation instructions.
    • Use of the API needs to be directly from a browser. Server-to-server integrations are not supported.

     
    Documentation

     

    JS API


    Applicable for

    • Web browsers, in cases where JS-Widget use is not applicable. Please consult with your account manager.

     
    Specifications

    • The JS-API provides a way to consume Outbrain recommendations data via JS library use. The developer is responsible for building the UI elements.
    • You should consider using JS API in cases where JS Widget use is not applicable. Please consult with your account manager.

    Documentation

     

    FAQ

        Web API JS API JS Widget

    TECHNOLOGY
               
    Technology Skills Needed Any development language that can invoke a standard HTTP API Javascript None. The Outbrain Javascript library populates the widget for you.
    Am I responsible for reporting and handling clicks? Yes Yes No

    UI
               
    Does Outbrain provide the UI? No, the developer needs to build the UI No, the developer needs to build the UI Yes. You can control the UI in coordination with your Account Manager, based on the JS Widget capabilities.
    Can I run UI A/B tests? No No Yes, in coordination with your Account Manager
    What type of UI experiences are supported? It’s up to the developer in compliance with the Outbrain contract. It’s up to the developer in compliance with the Outbrain contract. Multiple UI options — ask your Account Manager
    Do I need to add Outbrain labeling and a link to the Outbrain privacy policy? Yes Yes This is handled by Outbrain as part of the widget code.