API-FOOTBALL
Sports & Fitness
Get information about Football Leagues & Cups
Auth
apiKey
HTTPS
Yes
CORS
Yes
Common Use Cases
- •Display live scores and sports statistics
- •Build fantasy sports and prediction platforms
- •Create athlete performance tracking tools
Integration Guide
Review the API Documentation
Visit the official API-FOOTBALL documentation to understand available endpoints, request formats, and response structures. Familiarize yourself with the API's rate limits and usage policies before integration.
Obtain an API Key
API-FOOTBALL requires an API key for authentication. Register on the provider's website to get your unique key. Keep it secure and never expose it in client-side code — use environment variables or a backend proxy.
Use HTTPS for Secure Requests
API-FOOTBALL supports HTTPS, ensuring encrypted communication. Always use HTTPS endpoints in production to protect data in transit and comply with modern web security standards.
CORS Enabled — Direct Browser Access
API-FOOTBALL has CORS enabled, meaning you can make requests directly from the browser. This is ideal for frontend-only applications built with React, Vue, or vanilla JavaScript.
Implement and Test
Write your API integration code, start with a simple test request to verify connectivity. Implement proper error handling for network failures, rate limits, and invalid responses. Monitor your API usage to stay within any limits.
Code Examples
JavaScript / Fetch API:
// JavaScript example (with API key)
const apiKey = process.env.API_KEY; // Store your key securely
fetch("https://www.api-football.com/documentation-v3", {
headers: {
"Authorization": `Bearer ${apiKey}`,
// Or use: "X-API-Key": apiKey
// Check the docs for the correct header format
}
})
.then(response => {
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
return response.json();
})
.then(data => {
console.log("API response:", data);
})
.catch(error => {
console.error("Error fetching from API-FOOTBALL:", error);
});Python / Requests:
# Python example (with API key)
import requests
import os
api_key = os.environ.get("API_KEY") # Store your key securely
headers = {
"Authorization": f"Bearer {api_key}",
# Or use: "X-API-Key": api_key
}
response = requests.get("https://www.api-football.com/documentation-v3", headers=headers)
if response.status_code == 200:
data = response.json()
print("API response:", data)
else:
print(f"Error: {response.status_code}")