> For the complete documentation index, see [llms.txt](https://bogos-api-integration.gitbook.io/bogos-api-integration/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bogos-api-integration.gitbook.io/bogos-api-integration/overview.md).

# Overview

BOGOS provides two integration methods. Choose the one that best fits your technical needs and level of customization:

1. [**Integration with BOGOS API**](/bogos-api-integration/integration-steps.md)\
   You call the BOGOS REST API directly and render every offer yourself. Best when you want advanced customization and full control over the response data.
2. [**Integration with BOGOS JS/SDK**](/bogos-api-integration/bogos-js-sdk.md)\
   You load the BOGOS script, which renders the offers for you. Best when you want to set up many offer types quickly with minimal code.

## Which one should I use?

|                        | BOGOS API                               | BOGOS JS/SDK                            |
| ---------------------- | --------------------------------------- | --------------------------------------- |
| **Integration effort** | Higher — you build the UI               | Lower — drop-in script                  |
| **Rendering**          | You render every offer                  | BOGOS renders offers for you            |
| **Customization**      | Full control over data and UI           | UI provided; customize via events & CSS |
| **Offers covered**     | Gift, Bundle, Upsell, Discount, Booster | Gift, Bundle, Upsell, Discount, Booster |
| **Authentication**     | JWT token + `verify` header             | `data-bogos-key` on the script tag      |
| **Best for**           | Headless stores needing full control    | Quick setup across many offer types     |

```mermaid
flowchart TD
    A{Want BOGOS to render<br/>the offer UI for you?} -- Yes --> B[BOGOS JS/SDK]
    A -- No, I need full control --> C[BOGOS API]
    B --> D[Load the script + dispatch events]
    C --> E[Call the REST API + render yourself]
```

{% hint style="info" %}
New here? Start with the [Quickstart](/bogos-api-integration/quickstart.md). Need more information? Contact us via live chat on [BOGOS: Free Gift](https://apps.shopify.com/freegifts) or email <help@bogos.io>.
{% endhint %}