poprox_concepts.domain

class poprox_concepts.domain.Account(*, account_id=None, email=None, zip5=None, compensation=None, status, source=None, subsource=None, placebo_id=None, created_at=None)

Bases: BaseModel

Parameters:

• account_id (UUID)

• email (str | None)

• zip5 (str | None)

• compensation (str | None)

• status (str)

• source (str | None)

• subsource (str | None)

• placebo_id (str | None)

• created_at (datetime | None)

class poprox_concepts.domain.AccountInterest(*, account_id=None, entity_id, entity_name, preference, frequency=None)

Bases: BaseModel

Parameters:

• account_id (UUID | None)

• entity_id (UUID)

• entity_name (str)

• preference (int)

• frequency (int | None)

class poprox_concepts.domain.Article(*, article_id=None, headline, subhead=None, body=None, url=None, preview_image_id=None, mentions=[], source=None, external_id=None, raw_data=None, images=None, published_at=datetime.datetime(1970, 1, 1, 0, 0, tzinfo=datetime.timezone.utc), created_at=None)

Bases: BaseModel

Parameters:

• article_id (UUID)

• headline (str)

• subhead (str | None)

• body (str | None)

• url (str | None)

• preview_image_id (UUID | None)

• mentions (list[Mention])

• source (str | None)

• external_id (str | None)

• raw_data (dict[str, Any] | None)

• images (list[Image] | None)

• published_at (datetime)

• created_at (datetime | None)

class poprox_concepts.domain.ArticlePlacement(*, placement_id=None, article_id, url=None, section=None, level=None, image_url=None, created_at=datetime.datetime(2025, 9, 9, 17, 52, 50, 899123, tzinfo=datetime.timezone.utc))

Bases: BaseModel

Parameters:

• placement_id (UUID)

• article_id (UUID)

• url (str | None)

• section (str | None)

• level (str | None)

• image_url (str | None)

• created_at (datetime)

class poprox_concepts.domain.CandidateSet(*, articles, **extra_data)

Bases: BaseModel

Parameters:

• articles (list[Article])

• extra_data (Any)

class poprox_concepts.domain.Click(*, article_id, newsletter_id=None, timestamp=None)

Bases: BaseModel

Parameters:

• article_id (UUID)

• newsletter_id (UUID | None)

• timestamp (datetime | None)

class poprox_concepts.domain.Demographics(*, demographic_id=None, account_id, gender, birth_year=None, zip3, education, race, email_client=None)

Bases: BaseModel

Parameters:

• demographic_id (UUID)

• account_id (UUID)

• gender (str)

• birth_year (int | None)

• zip3 (str)

• education (str)

• race (str)

• email_client (str | None)

class poprox_concepts.domain.Entity(*, entity_id=None, external_id=None, name, entity_type, source, raw_data=None)

Bases: BaseModel

Parameters:

• entity_id (UUID | None)

• external_id (str | None)

• name (str)

• entity_type (str)

• source (str)

• raw_data (dict[str, Any] | None)

class poprox_concepts.domain.Image(*, image_id=None, url, caption=None, source, external_id=None, raw_data=None)

Bases: BaseModel

Parameters:

• image_id (UUID | None)

• url (str)

• caption (str | None)

• source (str)

• external_id (str | None)

• raw_data (dict[str, Any] | None)

class poprox_concepts.domain.Impression(*, impression_id=None, newsletter_id, position, article, created_at=None, extra=None, headline=None, subhead=None, feedback=None, section_name=None, position_in_section=None)

Bases: BaseModel

Parameters:

• impression_id (UUID)

• newsletter_id (UUID | None)

• position (int)

• article (Article)

• created_at (datetime | None)

• extra (dict[str, Any] | None)

• headline (str | None)

• subhead (str | None)

• feedback (bool | None)

• section_name (str | None)

• position_in_section (int | None)

class poprox_concepts.domain.InterestProfile(*, profile_id=None, click_history, click_topic_counts=None, click_locality_counts=None, article_feedbacks=None, onboarding_topics, **extra_data)

Bases: BaseModel

Parameters:

• profile_id (UUID | None)

• click_history (list[Click])

• click_topic_counts (dict[str, int] | None)

• click_locality_counts (dict[str, int] | None)

• article_feedbacks (dict[UUID, bool] | None)

• onboarding_topics (list[AccountInterest])

• extra_data (Any)

class poprox_concepts.domain.Mention(*, article_id=None, mention_id=None, source, relevance, entity)

Bases: BaseModel

Parameters:

• article_id (UUID | None)

• mention_id (UUID | None)

• source (str)

• relevance (float)

• entity (Entity)

class poprox_concepts.domain.Newsletter(*, newsletter_id=None, account_id, treatment_id=None, experience_id=None, impressions, subject, body_html, created_at=None, recommender_info=None, feedback=None)

Bases: BaseModel

Parameters:

• newsletter_id (UUID)

• account_id (UUID)

• treatment_id (UUID | None)

• experience_id (UUID | None)

• impressions (list[Impression])

• subject (str)

• body_html (str)

• created_at (datetime | None)

• recommender_info (RecommenderInfo | None)

• feedback (str | None)

class poprox_concepts.domain.RecommendationList(*, articles=None, extras=None)

Bases: BaseModel

Parameters:

• articles (list[Article])

• extras (list[dict[str, JsonValue]])

class poprox_concepts.domain.TopNewsHeadline(*, article_id=None, entity_id=None, topic, headline, position, as_of)

Bases: BaseModel

Parameters:

• article_id (UUID | None)

• entity_id (UUID | None)

• topic (str)

• headline (str)

• position (int)

• as_of (datetime)

class poprox_concepts.domain.Experience(*, experience_id=None, recommender_id, team_id, name, start_date, end_date=None, created_at=None, template=None)

Bases: BaseModel

Parameters:

• experience_id (UUID | None)

• recommender_id (UUID)

• team_id (UUID | None)

• name (str)

• start_date (date)

• end_date (date | None)

• created_at (datetime | None)

• template (str | None)

class poprox_concepts.domain.WebLogin(*, account_id, newsletter_id=None, endpoint, created_at)

Bases: BaseModel

Parameters:

• account_id (UUID)

• newsletter_id (UUID | None)

• endpoint (str)

• created_at (datetime)

Modules

account
article
click
demographics
experience
image
login
newsletter
profile
recommendation
topics