generated: '2026-09-25'
method: derived
generator: derive-data-model.py
source:
- openapi/findlocal-bluesky-api-openapi.yml
- openapi/findlocal-github-api-openapi.yml
- openapi/findlocal-history-api-openapi.yml
- openapi/findlocal-instagram-api-openapi.yml
- openapi/findlocal-linktree-api-openapi.yml
- openapi/findlocal-mastodon-api-openapi.yml
- openapi/findlocal-medium-api-openapi.yml
- openapi/findlocal-movers-api-openapi.yml
- openapi/findlocal-nichos-api-openapi.yml
- openapi/findlocal-openapi-full.json
- openapi/findlocal-pinterest-api-openapi.yml
- openapi/findlocal-soundcloud-api-openapi.yml
notation: has_one = property $ref; has_many = array of $ref; belongs_to = <entity>_id field
summary:
  entities: 11
  entities_in_spec: 11
  relationships: 3
entities:
- name: ApiError
  fields: 9
- name: Author
  fields: 12
  description: 'The same twelve names on every platform. A field that does not exist there is null, never absent
    and never zero: zero is a fact about the account, null is a fact about our reading.'
- name: Error
  fields: 1
- name: Event
  fields: 27
- name: Item
  fields: 9
- name: Mover
  fields: 7
  description: 'One item that GAINED points between the two compared windows. Items that lost points, and items
    present in only one of the two windows, are not in this list — losing is not traction, and an item with '
- name: PostItem
  fields: 9
- name: PostsEnvelope
  fields: 8
  description: Same envelope as every other route. `data.items` carries the posts the account itself wrote — reposts
    and boosts of other people are excluded by authorship. `has_more` is false and `next_cursor` is nu
- name: ProfileEnvelope
  fields: 13
  description: Identical shape on success and on error, so a client writes one parser. `success` is the only field
    that decides; `data` and `error` are mutually exclusive and the other is null, never absent.
- name: SeriesPoint
  fields: 4
  description: One observation of one item, in one hourly window.
- name: Venue
  fields: 13
relationships:
- from: Event
  to: Venue
  type: belongs_to
  via: venue_id
- from: Event
  to: Author
  type: belongs_to
  via: author_ids
- from: Item
  to: SeriesPoint
  type: has_many
  via: series