# Ranking Data API V2

## Ranking Men

> \## Endpoint Description\
> \
> This endpoint retrieves the current rankings of men's cricket players across different formats, including One Day Internationals (ODI), Test matches, and T20 matches. The rankings are categorized into all-rounders, batsmen, and bowlers, providing a comprehensive overview of player performance.\
> \
> \### Request Format\
> \
> \- \*\*Method\*\*: GET\
> &#x20;   \
> \- \*\*URL\*\*: \`<https://apiv3.sportsapi360.com/cricket/api/v2/ranking/men\\`\\>
> &#x20;   \
> \- \*\*Request Body\*\*: None\
> &#x20;   \
> \
> \### Response Structure\
> \
> The response is a JSON object containing the rankings for men's cricket players, structured as follows:\
> \
> \- \*\*ODI\*\*:\
> &#x20;   \
> &#x20;   \- \*\*men\*\*:\
> &#x20;       \
> &#x20;       \- \*\*allrounder\*\*: Contains details about all-rounder rankings.\
> &#x20;           \
> &#x20;           \- \*\*matchType\*\*: Type of match (e.g., ODI).\
> &#x20;               \
> &#x20;           \- \*\*gender\*\*: Gender of the players (always "male" for this endpoint).\
> &#x20;               \
> &#x20;           \- \*\*rank\*\*: An array of ranking objects, each representing a player.\
> &#x20;               \
> &#x20;               \- \*\*playerName\*\*: Name of the player.\
> &#x20;                   \
> &#x20;               \- \*\*playerID\*\*: Unique identifier for the player.\
> &#x20;                   \
> &#x20;               \- \*\*position\*\*: Ranking position of the player.\
> &#x20;                   \
> &#x20;               \- \*\*Points\*\*: Points scored by the player.\
> &#x20;                   \
> &#x20;               \- \*\*teamID\*\*: Unique identifier for the team.\
> &#x20;                   \
> &#x20;               \- \*\*teamName\*\*: Name of the team.\
> &#x20;                   \
> &#x20;       \- \*\*bat\*\*: Similar structure as all-rounder, but for batsmen.\
> &#x20;           \
> &#x20;       \- \*\*bowl\*\*: Similar structure as all-rounder, but for bowlers.\
> &#x20;           \
> \- \*\*Test\*\*: Same structure as ODI, but for Test match rankings.\
> &#x20;   \
> \- \*\*T20\*\*: Same structure as ODI, but for T20 match rankings.\
> &#x20;   \
> \
> This endpoint provides a comprehensive and structured view of the rankings of men's cricket players, allowing users to access detailed performance metrics across different formats.

```json
{"openapi":"3.0.0","info":{"title":"CRICKET API V3","version":"1.0.0"},"tags":[{"name":"Ranking Data API V2"}],"servers":[{"url":"https://apiv3.sportsapi360.com"}],"security":[{"apikeyAuth":[]}],"components":{"securitySchemes":{"apikeyAuth":{"type":"http","scheme":"x-api-key"}}},"paths":{"/cricket/api/v2/ranking/men":{"get":{"tags":["Ranking Data API V2"],"summary":"Ranking Men","description":"## Endpoint Description\n\nThis endpoint retrieves the current rankings of men's cricket players across different formats, including One Day Internationals (ODI), Test matches, and T20 matches. The rankings are categorized into all-rounders, batsmen, and bowlers, providing a comprehensive overview of player performance.\n\n### Request Format\n\n- **Method**: GET\n    \n- **URL**: `https://apiv3.sportsapi360.com/cricket/api/v2/ranking/men`\n    \n- **Request Body**: None\n    \n\n### Response Structure\n\nThe response is a JSON object containing the rankings for men's cricket players, structured as follows:\n\n- **ODI**:\n    \n    - **men**:\n        \n        - **allrounder**: Contains details about all-rounder rankings.\n            \n            - **matchType**: Type of match (e.g., ODI).\n                \n            - **gender**: Gender of the players (always \"male\" for this endpoint).\n                \n            - **rank**: An array of ranking objects, each representing a player.\n                \n                - **playerName**: Name of the player.\n                    \n                - **playerID**: Unique identifier for the player.\n                    \n                - **position**: Ranking position of the player.\n                    \n                - **Points**: Points scored by the player.\n                    \n                - **teamID**: Unique identifier for the team.\n                    \n                - **teamName**: Name of the team.\n                    \n        - **bat**: Similar structure as all-rounder, but for batsmen.\n            \n        - **bowl**: Similar structure as all-rounder, but for bowlers.\n            \n- **Test**: Same structure as ODI, but for Test match rankings.\n    \n- **T20**: Same structure as ODI, but for T20 match rankings.\n    \n\nThis endpoint provides a comprehensive and structured view of the rankings of men's cricket players, allowing users to access detailed performance metrics across different formats.","parameters":[{"name":"x-api-key","in":"header","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","headers":{},"content":{"application/json":{"schema":{"type":"object"}}}}}}}}}
```

## Ranking Women

> \### Endpoint Description\
> \
> This API endpoint retrieves the latest women's cricket rankings across different match formats including ODI, Test, and T20.\
> \
> \### Request\
> \
> \- \*\*Method:\*\* GET\
> &#x20;   \
> \- \*\*Endpoint:\*\* \`<https://apiv3.sportsapi360.com/cricket/api/v2/ranking/women\\`\\>
> &#x20;   \
> \
> \### Response Format\
> \
> The response will be in JSON format and contains rankings for women players categorized by match type. The structure of the response includes:\
> \
> \- \*\*ODI\*\*\
> &#x20;   \
> &#x20;   \- \*\*women\*\*\
> &#x20;       \
> &#x20;       \- \*\*allrounder\*\*\
> &#x20;           \
> &#x20;           \- \*\*matchType\*\*: (string) Type of match.\
> &#x20;               \
> &#x20;           \- \*\*gender\*\*: (string) Gender of the players.\
> &#x20;               \
> &#x20;           \- \*\*rank\*\*: (array) List of players with their ranking details.\
> &#x20;               \
> &#x20;               \- \*\*playerName\*\*: (string) Name of the player.\
> &#x20;                   \
> &#x20;               \- \*\*playerID\*\*: (string) Unique identifier for the player.\
> &#x20;                   \
> &#x20;               \- \*\*position\*\*: (integer) Ranking position of the player.\
> &#x20;                   \
> &#x20;               \- \*\*Points\*\*: (string) Points accumulated by the player.\
> &#x20;                   \
> &#x20;               \- \*\*teamID\*\*: (string) Unique identifier for the team.\
> &#x20;                   \
> &#x20;               \- \*\*teamName\*\*: (string) Name of the team.\
> &#x20;                   \
> &#x20;       \- \*\*bat\*\*: Similar structure as allrounder for batting rankings.\
> &#x20;           \
> &#x20;       \- \*\*bowl\*\*: Similar structure as allrounder for bowling rankings.\
> &#x20;           \
> \- \*\*Test\*\*\
> &#x20;   \
> &#x20;   \- Structure is similar to ODI, but may contain null values for rankings.\
> &#x20;       \
> \- \*\*T20\*\*\
> &#x20;   \
> &#x20;   \- Structure is similar to ODI, with rankings for allrounders, batsmen, and bowlers.\
> &#x20;       \
> \
> \### Notes\
> \
> \- The response may include null values for certain fields if there are no rankings available.\
> &#x20;   \
> \- Ensure to handle cases where rankings may not be present for all categories.

```json
{"openapi":"3.0.0","info":{"title":"CRICKET API V3","version":"1.0.0"},"tags":[{"name":"Ranking Data API V2"}],"servers":[{"url":"https://apiv3.sportsapi360.com"}],"security":[{"apikeyAuth":[]}],"components":{"securitySchemes":{"apikeyAuth":{"type":"http","scheme":"x-api-key"}}},"paths":{"/cricket/api/v2/ranking/women":{"get":{"tags":["Ranking Data API V2"],"summary":"Ranking Women","description":"### Endpoint Description\n\nThis API endpoint retrieves the latest women's cricket rankings across different match formats including ODI, Test, and T20.\n\n### Request\n\n- **Method:** GET\n    \n- **Endpoint:** `https://apiv3.sportsapi360.com/cricket/api/v2/ranking/women`\n    \n\n### Response Format\n\nThe response will be in JSON format and contains rankings for women players categorized by match type. The structure of the response includes:\n\n- **ODI**\n    \n    - **women**\n        \n        - **allrounder**\n            \n            - **matchType**: (string) Type of match.\n                \n            - **gender**: (string) Gender of the players.\n                \n            - **rank**: (array) List of players with their ranking details.\n                \n                - **playerName**: (string) Name of the player.\n                    \n                - **playerID**: (string) Unique identifier for the player.\n                    \n                - **position**: (integer) Ranking position of the player.\n                    \n                - **Points**: (string) Points accumulated by the player.\n                    \n                - **teamID**: (string) Unique identifier for the team.\n                    \n                - **teamName**: (string) Name of the team.\n                    \n        - **bat**: Similar structure as allrounder for batting rankings.\n            \n        - **bowl**: Similar structure as allrounder for bowling rankings.\n            \n- **Test**\n    \n    - Structure is similar to ODI, but may contain null values for rankings.\n        \n- **T20**\n    \n    - Structure is similar to ODI, with rankings for allrounders, batsmen, and bowlers.\n        \n\n### Notes\n\n- The response may include null values for certain fields if there are no rankings available.\n    \n- Ensure to handle cases where rankings may not be present for all categories.","parameters":[{"name":"x-api-key","in":"header","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","headers":{},"content":{"application/json":{"schema":{"type":"object"}}}}}}}}}
```

## Ranking Team

> \## Endpoint Description\
> \
> This API endpoint retrieves the current rankings of cricket teams across different formats (ODI, Test, T20) for both men and women.\
> \
> \### Request\
> \
> \- \*\*Method\*\*: GET\
> &#x20;   \
> \- \*\*Endpoint\*\*: \`<https://apiv3.sportsapi360.com/cricket/api/v2/ranking/team\\`\\>
> &#x20;   \
> \
> \### Response Format\
> \
> The response will be a JSON object containing the rankings for each format of cricket. The structure of the response is as follows:\
> \
> \- \*\*ODI\*\*:\
> &#x20;   \
> &#x20;   \- \*\*men\*\*:\
> &#x20;       \
> &#x20;       \- \*\*team\*\*:\
> &#x20;           \
> &#x20;           \- \*\*matchType\*\*: (string)\
> &#x20;               \
> &#x20;           \- \*\*rank\*\*: (array of objects)\
> &#x20;               \
> &#x20;               \- \*\*position\*\*: (string)\
> &#x20;                   \
> &#x20;               \- \*\*Rating\*\*: (string)\
> &#x20;                   \
> &#x20;               \- \*\*teamName\*\*: (string)\
> &#x20;                   \
> &#x20;               \- \*\*teamID\*\*: (string)\
> &#x20;                   \
> &#x20;   \- \*\*women\*\*:\
> &#x20;       \
> &#x20;       \- \*\*team\*\*:\
> &#x20;           \
> &#x20;           \- \*\*matchType\*\*: (string)\
> &#x20;               \
> &#x20;           \- \*\*rank\*\*: (array of objects)\
> &#x20;               \
> &#x20;               \- \*\*position\*\*: (string)\
> &#x20;                   \
> &#x20;               \- \*\*Rating\*\*: (string)\
> &#x20;                   \
> &#x20;               \- \*\*teamName\*\*: (string)\
> &#x20;                   \
> &#x20;               \- \*\*teamID\*\*: (string)\
> &#x20;                   \
> \- \*\*Test\*\*:\
> &#x20;   \
> &#x20;   \- \*\*men\*\*:\
> &#x20;       \
> &#x20;       \- \*\*team\*\*:\
> &#x20;           \
> &#x20;           \- \*\*matchType\*\*: (string)\
> &#x20;               \
> &#x20;           \- \*\*rank\*\*: (array of objects)\
> &#x20;               \
> &#x20;               \- \*\*position\*\*: (string)\
> &#x20;                   \
> &#x20;               \- \*\*Rating\*\*: (string)\
> &#x20;                   \
> &#x20;               \- \*\*teamName\*\*: (string)\
> &#x20;                   \
> &#x20;               \- \*\*teamID\*\*: (string)\
> &#x20;                   \
> &#x20;   \- \*\*women\*\*:\
> &#x20;       \
> &#x20;       \- \*\*team\*\*:\
> &#x20;           \
> &#x20;           \- \*\*matchType\*\*: (null)\
> &#x20;               \
> &#x20;           \- \*\*rank\*\*: (null)\
> &#x20;               \
> \- \*\*T20\*\*:\
> &#x20;   \
> &#x20;   \- \*\*men\*\*:\
> &#x20;       \
> &#x20;       \- \*\*team\*\*:\
> &#x20;           \
> &#x20;           \- \*\*matchType\*\*: (string)\
> &#x20;               \
> &#x20;           \- \*\*rank\*\*: (array of objects)\
> &#x20;               \
> &#x20;               \- \*\*position\*\*: (string)\
> &#x20;                   \
> &#x20;               \- \*\*Rating\*\*: (string)\
> &#x20;                   \
> &#x20;               \- \*\*teamName\*\*: (string)\
> &#x20;                   \
> &#x20;               \- \*\*teamID\*\*: (string)\
> &#x20;                   \
> &#x20;   \- \*\*women\*\*:\
> &#x20;       \
> &#x20;       \- \*\*team\*\*:\
> &#x20;           \
> &#x20;           \- \*\*matchType\*\*: (string)\
> &#x20;               \
> &#x20;           \- \*\*rank\*\*: (array of objects)\
> &#x20;               \
> &#x20;               \- \*\*position\*\*: (string)\
> &#x20;                   \
> &#x20;               \- \*\*Rating\*\*: (string)\
> &#x20;                   \
> &#x20;               \- \*\*teamName\*\*: (string)\
> &#x20;                   \
> &#x20;               \- \*\*teamID\*\*: (string)\
> &#x20;                   \
> \
> \### Notes\
> \
> \- The \`matchType\` indicates the type of match for which the ranking is applicable.\
> &#x20;   \
> \- The \`rank\` array contains the ranking details for each team, including their position, rating, name, and unique identifier.

```json
{"openapi":"3.0.0","info":{"title":"CRICKET API V3","version":"1.0.0"},"tags":[{"name":"Ranking Data API V2"}],"servers":[{"url":"https://apiv3.sportsapi360.com"}],"security":[{"apikeyAuth":[]}],"components":{"securitySchemes":{"apikeyAuth":{"type":"http","scheme":"x-api-key"}}},"paths":{"/cricket/api/v2/ranking/team":{"get":{"tags":["Ranking Data API V2"],"summary":"Ranking Team","description":"## Endpoint Description\n\nThis API endpoint retrieves the current rankings of cricket teams across different formats (ODI, Test, T20) for both men and women.\n\n### Request\n\n- **Method**: GET\n    \n- **Endpoint**: `https://apiv3.sportsapi360.com/cricket/api/v2/ranking/team`\n    \n\n### Response Format\n\nThe response will be a JSON object containing the rankings for each format of cricket. The structure of the response is as follows:\n\n- **ODI**:\n    \n    - **men**:\n        \n        - **team**:\n            \n            - **matchType**: (string)\n                \n            - **rank**: (array of objects)\n                \n                - **position**: (string)\n                    \n                - **Rating**: (string)\n                    \n                - **teamName**: (string)\n                    \n                - **teamID**: (string)\n                    \n    - **women**:\n        \n        - **team**:\n            \n            - **matchType**: (string)\n                \n            - **rank**: (array of objects)\n                \n                - **position**: (string)\n                    \n                - **Rating**: (string)\n                    \n                - **teamName**: (string)\n                    \n                - **teamID**: (string)\n                    \n- **Test**:\n    \n    - **men**:\n        \n        - **team**:\n            \n            - **matchType**: (string)\n                \n            - **rank**: (array of objects)\n                \n                - **position**: (string)\n                    \n                - **Rating**: (string)\n                    \n                - **teamName**: (string)\n                    \n                - **teamID**: (string)\n                    \n    - **women**:\n        \n        - **team**:\n            \n            - **matchType**: (null)\n                \n            - **rank**: (null)\n                \n- **T20**:\n    \n    - **men**:\n        \n        - **team**:\n            \n            - **matchType**: (string)\n                \n            - **rank**: (array of objects)\n                \n                - **position**: (string)\n                    \n                - **Rating**: (string)\n                    \n                - **teamName**: (string)\n                    \n                - **teamID**: (string)\n                    \n    - **women**:\n        \n        - **team**:\n            \n            - **matchType**: (string)\n                \n            - **rank**: (array of objects)\n                \n                - **position**: (string)\n                    \n                - **Rating**: (string)\n                    \n                - **teamName**: (string)\n                    \n                - **teamID**: (string)\n                    \n\n### Notes\n\n- The `matchType` indicates the type of match for which the ranking is applicable.\n    \n- The `rank` array contains the ranking details for each team, including their position, rating, name, and unique identifier.","parameters":[{"name":"x-api-key","in":"header","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","headers":{},"content":{"application/json":{"schema":{"type":"object"}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docsv3.sportsapi360.com/cricket-docs/api-collection-cricket/ranking-data-api-v2.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
