Skip to main content

Best practices for API integration

Discover how to get the most out of our API.

Updated this week

Our APIs allow you to customize how Besitos offers appear on your platform. To create a clear and successful user experience, we strongly recommend displaying all available offer details so users understand how to start, progress, and complete offers.

Offer filtering

Provide users with a way to filter and discover game and deal offers within your interface. This can include a search field, category filters, sorting options, or other mechanisms that allow discovery beyond simple scrolling.

Both the Games API and Deals API include a categories attribute that can be used to support category-based filtering and improve offer discoverability.

Offers returned by the API are ordered by performance, with top-performing offers appearing first. Without search or filtering, users may interact only with the initial set of offers (e.g., the top 10) and miss relevant opportunities further down the list.

This approach helps users find offers that better match their interests and increases overall engagement across a wider range of offers.

Offer descriptions and details

The Games and Deals APIs include essential information users need to complete offers successfully, such as:

  • Offer descriptions

  • Goals and milestones

  • Time limits (including the days_left value)

  • Operating system requirements

We strongly recommend displaying the full offer description, goals, and details to ensure users clearly understand earning requirements before starting an offer.

In-progress and completed offers

If you use the Games User Data API or Deals User Data API to display a user’s offer activity, we recommend separating offers by status.

A common and effective approach is to include a dedicated tab or section for:

  • In-progress offers

  • Completed offers

This keeps active offers clearly distinct from available or not-yet-started offers, reducing user confusion.

Support link

Besitos provides direct support for end users. You may add a custom link to the Besitos Support team within your interface, either within offer details or in another prominent location.

This helps users quickly identify which offers the Besitos team supports.

Use the following format for your custom Support link:

https://wall.besitos.ai/support/[partnerID]/[userID]

For questions or assistance, contact your Besitos Account Manager or reach out to our Implementation Team at [email protected] or via your shared Slack project channel.

Did this answer your question?