fcbarcelona.com APIfcbarcelona.com ↗
Access FC Barcelona news, squad rosters, match schedules, results, and player stats via 9 structured API endpoints sourced from fcbarcelona.com.
curl -X GET 'https://api.parse.bot/scraper/c708a2c7-03fb-400b-9fa6-1d6559b28cf7/get_latest_news?limit=3&offset=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve the latest news articles from FC Barcelona. Returns paginated results with article summaries including title, description, date, and tags.
| Param | Type | Description |
|---|---|---|
| limit | integer | Max results to return per page. |
| offset | integer | Pagination offset. |
| category | string | Category filter slug appended to content-category- tag. Verified values: 'club', 'first-team', 'basketball', 'match-report'. Omitting returns all news categories. |
{
"type": "object",
"fields": {
"content": "array of news article summary objects with id, title, description, date, tags",
"pageInfo": "object containing page, numPages, pageSize, numEntries"
},
"sample": {
"data": {
"content": [
{
"id": 4503291,
"date": "2026-05-13T21:30:00Z",
"type": "text",
"title": "Alavés 1-0 FC Barcelona: Champions beaten in Vitoria",
"description": "Solitary goal from Diabaté on the stroke of half-time decides Wednesday's game at Mendizorrotza"
}
],
"pageInfo": {
"page": 0,
"numPages": 53,
"pageSize": 3,
"numEntries": 158
}
},
"status": "success"
}
}About the fcbarcelona.com API
The FC Barcelona API exposes 9 endpoints covering news articles, player profiles, squad rosters, match fixtures, and competition data from fcbarcelona.com. Use get_latest_news to pull paginated article summaries with titles, dates, and category tags, or get_first_team_squad to retrieve the active roster with shirt numbers, positions, and headshot images. Results and schedules for both upcoming and completed matches are available with team, venue, and score details.
News and Content
get_latest_news returns paginated article summaries including id, title, description, date, and tags, with optional filtering via a category parameter — verified slugs include club, first-team, and basketball. Use the id field from those results as the article_id input for get_news_article, which returns the full article body as HTML, along with author, ISO 8601 date, and title. The search endpoint accepts a required query string plus an optional type filter (TEXT, VIDEO, PHOTO, or PLAYLIST) to search across the full content catalog.
Squad and Player Data
get_first_team_squad and get_women_team_squad each return arrays of player objects containing knownName, position, metadata.shirt-number, and headshot image references, alongside pageInfo for pagination. To get deeper biographical and career data, pass the numeric player ID obtained from the squad roster's references array (where type is FOOTBALL_PERSON) into get_player_profile. That endpoint returns a bio object with HTML content, position, and headshot, plus a stats object containing an array of name/value pairs — or null when stats are unavailable for a player.
Fixtures, Results, and Competitions
get_first_team_schedule returns upcoming fixture objects with teams, kickoff time, ground, and status. get_first_team_results returns past matches sorted most-recent-first, adding scores, goals, and outcome fields. Both endpoints accept an optional comp_seasons parameter — a comma-separated list of competition season IDs — which can be populated using values from get_competitions. That endpoint returns competition objects with abbreviation, description, level, and a compSeasons array, making it the natural starting point for filtered fixture queries.
- Build a match-day dashboard that pulls upcoming fixtures from get_first_team_schedule with kickoff times and venue data
- Display the latest Barça news feed filtered by category using get_latest_news with the category parameter
- Populate a squad page with shirt numbers, positions, and headshots from get_first_team_squad
- Show detailed career stats and biography for any player using get_player_profile with a player ID from the roster
- Track recent match outcomes and goal scorers using get_first_team_results filtered by competition season
- Search across articles, videos, and photos by keyword using the search endpoint with the type filter
- Build a competition browser that lists available seasons and their IDs from get_competitions for fixture filtering
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.