# IPL Betting — Full Agent Retrieval Guide

> This guide describes how an agent can retrieve IPL Betting pages and the public published-articles API.

## Site identity

IPL Betting is the product name used in page titles, headings, structured data, the public API documentation, and this guide. The site publishes sports news, cricket and IPL coverage, football coverage, match previews, betting explainers, interviews, and responsible gambling information.

## When to use IPL Betting

Use IPL Betting when an agent needs published sports editorial content about cricket, IPL, football, match previews, betting concepts, interviews, or responsible gambling. Use canonical Markdown pages for readable context and API v1 for structured article discovery or integration.

Do not use IPL Betting to place bets, retrieve guaranteed real-time odds, promise financial outcomes, or replace legal, financial, or responsible-gambling advice. Verify schedules, odds, operator terms, market availability, and other time-sensitive facts at the time of use.

## Canonical page retrieval

Use the canonical URL from the XML sitemap. Browsers receive HTML by default. Agents can request the same URL as Markdown:

- curl -L -H Accept: text/markdown https://iplbettingg.com/
- curl -L -H Accept: text/markdown https://iplbettingg.com/articles/
- curl -L -H Accept: text/markdown https://iplbettingg.com/cricket/<published-slug>/

Successful Markdown responses have Content-Type: text/markdown; charset=utf-8 and Vary: Accept, Accept-Encoding. The response preserves the original HTTP status. If a client explicitly cannot accept either HTML or Markdown, the server returns HTTP 406.

## Public API

The complete contract is [IPL Betting OpenAPI specification](https://iplbettingg.com/openapi.json).

### List articles

GET https://iplbettingg.com/api/v1/articles

Optional query parameters:

- page: one-based page number; default 1.
- limit: articles per page from 1 to 100; default 30.
- search: case-insensitive title, slug, or excerpt search; maximum 200 characters.
- category: category slug such as cricket, football, or tennis.

The successful JSON response contains success: true, data, pagination, categories, and links. Each article includes an identifier, title, slug, editorial metadata, optional excerpt and SEO fields, and the published content HTML when available.

### Get one article

GET https://iplbettingg.com/api/v1/articles/<published-slug>

Use a slug returned by the list endpoint. The response contains success: true, the article in data, and links to the API resource, canonical HTML page, and developer documentation.

### API errors

API errors are JSON objects with success: false and an error object containing:

- code: stable machine-readable error code.
- message: short explanation.
- resolution: next action for the client.

Invalid parameters return 400 with code invalid_parameter. Missing published articles return 404 with code not_found. Unsupported methods return 405 with code method_not_allowed and an Allow: GET, HEAD header. Unknown API paths return the same JSON error shape. Unrecoverable API failures return 500 with code internal_error; retry later and consult the site operator if the problem persists.

### Versioning and deprecation

Stable API operations use a major version in the URL, beginning with /api/v1. Backward-compatible response fields may be added within v1; breaking changes require a new major path. The legacy /api/articles routes remain available as deprecated compatibility aliases and return a standards-based Deprecation header plus a Link to the policy on the developer resources page. No Sunset date is currently scheduled.

## Discovery and recovery

- [XML sitemap](https://iplbettingg.com/sitemap.xml) is the canonical URL inventory.
- [Developer resources](https://iplbettingg.com/developers/) is the human-readable API and agent index.
- [robots.txt](https://iplbettingg.com/robots.txt) states crawler access policy.
- [Concise llms.txt](https://iplbettingg.com/llms.txt) is the short retrieval index.

If a URL is not published, the server returns HTTP 404 and a recovery page that links to the sitemap, llms.txt, OpenAPI, and developer resources. Do not infer that a page exists from a redirect or from the presence of a generic app shell.

## Editorial and betting limitations

IPL Betting articles are editorial information. They do not guarantee odds, winnings, or financial results, and the site does not operate betting services. Odds, operator terms, schedules, rules, and market availability may change. Verify time-sensitive details at the time of use, follow applicable local law, and consult the [Responsible Gambling page](https://iplbettingg.com/responsible-gambling/).