BLK Bestsellers ONIX 3.0 Feed

Overview & Endpoints

The AALBC BLK Bestsellers List Feed delivers monthly point-of-sale rankings tracked by Circana and curated by AALBC.com. Published in standard ONIX for Books Release 3.0, each monthly period contains 160 ranked titles across adult, young adult, children’s, poetry, and nonfiction categories (Methodology).

Live Feed Endpoint (Latest Month)

GET https://aalbc.com/feeds/blk-bestsellers-onix.xml Inspect XML →

Historical Archive Endpoint

GET https://aalbc.com/feeds/blk-bestsellers-onix.xml?period=YYYY-MM-01

Format: ONIX 3.0 Reference Update Frequency: Monthly Encoding: UTF-8 Payload: 160 Titles / Period

ONIX 3.0 Element Mapping

Bibliographic metadata, author authority identifiers, and Circana-backed monthly bestseller rankings map directly to standard EDItEUR ONIX 3.0 elements:

ONIX 3.0 Element	Mapping Identifier	Definition & Output Format
`<RecordReference>`	Composite Identifier	Unique record key: `AALBC-BLK-{ISBN13}-{YYYYMM}`
`<ProductIdentifier>`	Book ISBN-13	Standard ISBN-13 (`ProductIDType 15`).
`<ProductForm>`	Book Format	Mapped ONIX form codes: `BB` (Hardback), `BC` (Paperback), `EA` (E-book), `AJ` (Audiobook).
`<TitleText>`	Book Title	Distinctive title of the work.
`<Contributor>`	Author Metadata	Primary author name (`ContributorRole A01`) and biographical sequence.
`<PersonIdentifier>`	Author ISNI	International Standard Name Identifier (`PersonIDType 16`) for global author entity disambiguation.
`<SubjectHeadingText>`	Chart Category	Bestseller category classification (`SubjectSchemeIdentifier 20`).
`<TextContent>`	Editorial Logline	Short editorial annotation hook and summary (`TextType 02`).
`<CitedContent>`	Ranking & Longevity	Bestseller list citation (`CitedContentType 02`, `SourceType 02`), category position (`<PositionOnList>`), and cumulative chart history inside `<CitationNote>`.
`<PublishingDetail>`	Publisher & Release Date	Publishing imprint entity and official release date (`YYYYMMDD`).
`<SupplyDetail>`	Retail Price	Suggested Retail List Price in USD (`PriceType 01`).

Sample Product XML Record

<Product>
  <RecordReference>AALBC-BLK-9780593444009-202608</RecordReference>
  <NotificationType>03</NotificationType>
  <RecordSourceType>04</RecordSourceType>
  <ProductIdentifier>
    <ProductIDType>15</ProductIDType>
    <IDValue>9780593444009</IDValue>
  </ProductIdentifier>
  <DescriptiveDetail>
    <ProductComposition>00</ProductComposition>
    <ProductForm>BB</ProductForm>
    <TitleDetail>
      <TitleType>01</TitleType>
      <TitleElement>
        <TitleElementLevel>01</TitleElementLevel>
        <TitleText>Example Bestselling Novel</TitleText>
      </TitleElement>
    </TitleDetail>
    <Contributor>
      <SequenceNumber>1</SequenceNumber>
      <ContributorRole>A01</ContributorRole>
      <PersonName>Author Name</PersonName>
      <PersonIdentifier>
        <PersonIDType>16</PersonIDType>
        <IDValue>0000000121487856</IDValue>
      </PersonIdentifier>
    </Contributor>
    <Subject>
      <SubjectSchemeIdentifier>20</SubjectSchemeIdentifier>
      <SubjectHeadingText>BLK Bestseller: Fiction</SubjectHeadingText>
    </Subject>
  </DescriptiveDetail>
  <CollateralDetail>
    <TextContent>
      <TextType>02</TextType>
      <ContentAudience>00</ContentAudience>
      <Text>An evocative story of family legacy and resilience across generations.</Text>
    </TextContent>
    <CitedContent>
      <CitedContentType>02</CitedContentType>
      <ContentAudience>00</ContentAudience>
      <SourceType>02</SourceType>
      <SourceTitle>AALBC BLK Bestsellers List</SourceTitle>
      <ListName>BLK Bestsellers List - Fiction</ListName>
      <PositionOnList>1</PositionOnList>
      <CitationNote>Total months on list: 4.</CitationNote>
    </CitedContent>
  </CollateralDetail>
  <PublishingDetail>
    <Imprint>
      <ImprintName>One World</ImprintName>
    </Imprint>
    <Publisher>
      <PublishingRole>01</PublishingRole>
      <PublisherName>One World</PublisherName>
    </Publisher>
    <PublishingDate>
      <PublishingDateRole>01</PublishingDateRole>
      <Date dateformat="00">20260414</Date>
    </PublishingDate>
  </PublishingDetail>
  <ProductSupply>
    <SupplyDetail>
      <Price>
        <PriceType>01</PriceType>
        <PriceAmount>28.00</PriceAmount>
        <CurrencyCode>USD</CurrencyCode>
      </Price>
    </SupplyDetail>
  </ProductSupply>
</Product>

Technical Contact & Ingestion Inquiries

Publishers, distributors, and bibliographic database administrators seeking automated polling configurations or custom industry delivery can contact:

Troy Johnson, Founder & Webmaster
Email: troy@aalbc.com | Phone: 347-69-AALBC

Welcome to AALBC

Resend Verification Link