Title: Usage Tips

URL Source: https://docs.shipp.ai/api-reference/usage-tips/

Markdown Content:
---
description: Usage Tips for the API
---

[ Skip to content](#usage-tips-for-agents-and-integrations) 

* [  How to Shipp ](../../how-to/)
* [  API Reference ](../)
* [  Versioning ](../versioning/)
* [  x402 Payments ](../x402/)
* [  Guides ](../../platform-guides/)
* [  Go To Shipp Dashboard ](https://platform.shipp.ai)

# Usage Tips

Diving Deep?

This page is designed for AI Agents & users developing code directly. See [Getting Started](../../) and [Platform Guides](../../platform-guides/)

---

## Usage Tips (for agents and integrations)[¶](#usage-tips-for-agents-and-integrations "Permanent link")

* Keep `filter_instructions` short, explicit, and testable:
* Mention the sport/league (e.g., NBA, NFL, MLB).
* Specify the scope (a specific game, today, a team, a list of teams, etc.).
* If you need certain stats/fields, mention them in your instructions so the classifier can retrieve relevant event fields.
* Store `connection_id` and reuse it rather than creating new connections per run.
* If you hit rate/usage limits, surface the error message directly to the user and retry later.

 Back to top