# FanFeed Partner API

- [FanFeed Partner API](https://docs.fanfeed.ai/index.md): Turn a user's camera roll into an attended-event history.
- [Conventions](https://docs.fanfeed.ai/conventions.md): Base URLs, headers, errors, timestamps, and pagination.
- [Authentication](https://docs.fanfeed.ai/authentication.md): Partner API key, user identification, and what to design around.
- [Creating a user](https://docs.fanfeed.ai/guides/create-user.md): Create a FanFeed user when your user opts in, and store the id.
- [Ingesting camera-roll metadata](https://docs.fanfeed.ai/guides/ingest-media.md): Batch photo metadata to FanFeed and get matched events back inline.
- [Events](https://docs.fanfeed.ai/guides/events.md): A user's matched event history, with media attached.
- [Profile statistics](https://docs.fanfeed.ai/guides/stats.md): Aggregate statistics derived from the event history.
- [Suggested build order](https://docs.fanfeed.ai/build-order.md): The order that surfaces integration problems earliest.
- [Open items](https://docs.fanfeed.ai/open-items.md): What is still being finalised, and who owns each one.
- [Create a user](https://docs.fanfeed.ai/api-reference/users/create-a-user.md): Call this once, after your user has agreed to the terms and tapped **Sync Now**.
- [Ingest a batch of camera-roll metadata](https://docs.fanfeed.ai/api-reference/media/ingest-a-batch-of-camera-roll-metadata.md): Send photo **metadata only**, never image bytes. FanFeed matches each item against venue and event data using its coordinates and capture time, and returns the matches **inline in the response for that batch**.
- [Record that a library scan finished](https://docs.fanfeed.ai/api-reference/sync/record-that-a-library-scan-finished.md): Call this **once at the end of a completed library scan**, not per batch.
- [List a user's matched events](https://docs.fanfeed.ai/api-reference/events/list-a-users-matched-events.md): The user's attended-event history, newest first, with the matched media attached to each event.
- [Get a user's profile statistics](https://docs.fanfeed.ai/api-reference/stats/get-a-users-profile-statistics.md): Aggregate statistics derived from the user's matched event history: the numbers behind a profile screen. Recomputed as new media is ingested.

## OpenAPI Specs

- [openapi](/api-reference/openapi.yaml)