Get a user's profile statistics

curl --request GET \
  --url https://api.fanfeed.ai/v1/users/{user_id}/stats \
  --header 'X-PARTNER-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-PARTNER-API-KEY': '<api-key>'}};

fetch('https://api.fanfeed.ai/v1/users/{user_id}/stats', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fanfeed.ai/v1/users/{user_id}/stats",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-PARTNER-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fanfeed.ai/v1/users/{user_id}/stats"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-PARTNER-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fanfeed.ai/v1/users/{user_id}/stats")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-PARTNER-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "total_events": 47,
  "total_venues": 23,
  "has_synced": true,
  "sports_count": 12,
  "concerts_count": 35,
  "first_attended": "2014-08-02",
  "most_recently_attended": "2026-06-13",
  "busiest_year": "2024",
  "top_season": "Summer",
  "top_artist": "Zach Bryan",
  "top_genre": "Country",
  "top_team": null,
  "top_league": null,
  "unique_venues": [
    {
      "venue": {
        "id": 4412,
        "name": "Madison Square Garden",
        "city": "New York",
        "region": "NY",
        "country": "US",
        "latitude": "<unknown>",
        "longitude": "<unknown>"
      },
      "visit_count": 6
    }
  ],
  "last_sync_at": "2026-08-25T18:44:12Z"
}

{
  "error": {
    "code": "invalid_batch_size",
    "message": "Send at most 200 media items per request.",
    "details": {}
  }
}

{
  "error": {
    "code": "invalid_batch_size",
    "message": "Send at most 200 media items per request.",
    "details": {}
  }
}

{
  "error": {
    "code": "invalid_batch_size",
    "message": "Send at most 200 media items per request.",
    "details": {}
  }
}

{
  "error": {
    "code": "invalid_batch_size",
    "message": "Send at most 200 media items per request.",
    "details": {}
  }
}

{
  "error": {
    "code": "invalid_batch_size",
    "message": "Send at most 200 media items per request.",
    "details": {}
  }
}

GET

users

{user_id}

stats

Get a user's profile statistics

curl --request GET \
  --url https://api.fanfeed.ai/v1/users/{user_id}/stats \
  --header 'X-PARTNER-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-PARTNER-API-KEY': '<api-key>'}};

fetch('https://api.fanfeed.ai/v1/users/{user_id}/stats', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fanfeed.ai/v1/users/{user_id}/stats",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-PARTNER-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fanfeed.ai/v1/users/{user_id}/stats"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-PARTNER-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fanfeed.ai/v1/users/{user_id}/stats")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-PARTNER-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "total_events": 47,
  "total_venues": 23,
  "has_synced": true,
  "sports_count": 12,
  "concerts_count": 35,
  "first_attended": "2014-08-02",
  "most_recently_attended": "2026-06-13",
  "busiest_year": "2024",
  "top_season": "Summer",
  "top_artist": "Zach Bryan",
  "top_genre": "Country",
  "top_team": null,
  "top_league": null,
  "unique_venues": [
    {
      "venue": {
        "id": 4412,
        "name": "Madison Square Garden",
        "city": "New York",
        "region": "NY",
        "country": "US",
        "latitude": "<unknown>",
        "longitude": "<unknown>"
      },
      "visit_count": 6
    }
  ],
  "last_sync_at": "2026-08-25T18:44:12Z"
}

{
  "error": {
    "code": "invalid_batch_size",
    "message": "Send at most 200 media items per request.",
    "details": {}
  }
}

{
  "error": {
    "code": "invalid_batch_size",
    "message": "Send at most 200 media items per request.",
    "details": {}
  }
}

{
  "error": {
    "code": "invalid_batch_size",
    "message": "Send at most 200 media items per request.",
    "details": {}
  }
}

{
  "error": {
    "code": "invalid_batch_size",
    "message": "Send at most 200 media items per request.",
    "details": {}
  }
}

{
  "error": {
    "code": "invalid_batch_size",
    "message": "Send at most 200 media items per request.",
    "details": {}
  }
}

Authorizations

X-PARTNER-API-KEY

string

header

required

Your FanFeed partner API key, issued to your organization.

FanFeed trusts your authentication: the key identifies you, and the user_id in the path identifies which of your users the request is for. FanFeed performs no end-user authentication of its own.

Treat the key as a server-side secret. See the guide for what that implies for the camera-roll ingest path, which is the one call that naturally originates on-device.

Path Parameters

user_id

string<uuid>

required

The FanFeed user id returned by POST /users.

Example:

"8f14e45f-ceea-467a-9a1e-2b4d9c3f0a11"

Response

Profile statistics.

All fields are snake_case, consistent with the rest of this API. Superlative fields are null for users with too little history to compute them.

total_events

integer

required

Example:

47

total_venues

integer

required

Example:

23

has_synced

boolean

required

Whether this user has ever completed a scan that examined the library. Read it at launch to decide between a full library scan and an incremental one.

Example:

true

sports_count

integer

default:0

A fresh profile has 0 sports events, not null.

Example:

12

concerts_count

integer

default:0

A fresh profile has 0 concert events, not null.

Example:

35

first_attended

string<date> | null

The calendar date at the venue, taken from the event's local start time, the same basis as starts_at_local, with the time dropped. Not a UTC date; do not convert it.

Example:

"2014-08-02"

most_recently_attended

string<date> | null

The calendar date at the venue, on the same basis as first_attended.

Example:

"2026-06-13"

busiest_year

string | null

Example:

"2024"

top_season

string | null

Example:

"Summer"

top_artist

string | null

Example:

"Zach Bryan"

top_genre

string | null

Example:

"Country"

top_team

string | null

Example:

null

top_league

string | null

Example:

null

unique_venues

object[]

Unique venues with visits, or an empty list for a fresh profile.

Show child attributes

last_sync_at

string<date-time> | null

Server-side timestamp of the last time FanFeed received media or a sync-complete for this user. null until FanFeed first receives anything.

Example:

"2026-08-25T18:44:12Z"

Users

Media

Sync

Events

Stats

Get a user's profile statistics

Authorizations

Path Parameters

Response