generated: '2026-09-25'
method: derived
generator: derive-vocabulary.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
vocabulary:
  name: FindLocal Domain Vocabulary
  description: 'Terms declared by FindLocal''s own API contract: its resource groups, objects and enumerations, with the contract''s definitions.
    Derived, not authored.'
  version: '2026-09-25'
  terms:
  - term: ProfileEnvelope
    definition: 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.
    tags:
    - Object
    source: openapi/findlocal-bluesky-api-openapi.yml#/components/schemas/ProfileEnvelope
  - term: PostsEnvelope
    definition: '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 null on all three platforms today: there is no deep pagination, and
      the fields are present so the shape does not change on the day there is.'
    tags:
    - Object
    source: openapi/findlocal-bluesky-api-openapi.yml#/components/schemas/PostsEnvelope
  - term: Author
    definition: '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.'
    tags:
    - Object
    source: openapi/findlocal-bluesky-api-openapi.yml#/components/schemas/Author
  - term: PostItem
    definition: 'Object declared by the contract with fields: id, url, text, text_html, title, position, published_at, thumbnail_url, metrics.'
    tags:
    - Object
    source: openapi/findlocal-bluesky-api-openapi.yml#/components/schemas/PostItem
  - term: ApiError
    definition: 'Object declared by the contract with fields: error, message, http, limit, renews_at, credits_balance, needed, spent_this_month,
      cap.'
    tags:
    - Object
    source: openapi/findlocal-movers-api-openapi.yml#/components/schemas/ApiError
  - term: Mover
    definition: 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 nothing to compare against has no delta.
    tags:
    - Object
    source: openapi/findlocal-movers-api-openapi.yml#/components/schemas/Mover
  - term: Event
    definition: 'Object declared by the contract with fields: id, title, description, event_date, start_time, end_time, category, event_type,
      performers, price, price_amount, detail_page_url. (15 more)'
    tags:
    - Object
    source: openapi/findlocal-openapi-full.json#/components/schemas/Event
  - term: Venue
    definition: 'Object declared by the contract with fields: id, name, city, region, address, latitude, longitude, type, categories, url, image,
      description. (1 more)'
    tags:
    - Object
    source: openapi/findlocal-openapi-full.json#/components/schemas/Venue
  - term: Error
    definition: 'Object declared by the contract with fields: error.'
    tags:
    - Object
    source: openapi/findlocal-openapi-full.json#/components/schemas/Error
  - term: SeriesPoint
    definition: One observation of one item, in one hourly window.
    tags:
    - Object
    source: openapi/findlocal-trends-api-openapi.yml#/components/schemas/SeriesPoint
  - term: Item
    definition: 'Object declared by the contract with fields: external_id, title, url, platform, entered_at, left_at, best_position, movement,
      series.'
    tags:
    - Object
    source: openapi/findlocal-trends-api-openapi.yml#/components/schemas/Item