Overview & Endpoints
The AALBC BLK Bestsellers Feed delivers monthly point-of-sale rankings tracked by Circana and curated by AALBC.com. Published in standard ONIX for Books Release 3.0 (Reference Names), each monthly period contains 160 ranked titles across adult, young adult, children’s, poetry, and nonfiction categories.
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
This feed maps database records from aview_blk_detail and vbooksummary2 into EDItEUR ONIX 3.0 elements:
| ONIX 3.0 Element | Source Field | Definition & Output Format |
|---|---|---|
<RecordReference> |
b.isbn + b.period |
Unique composite key: AALBC-BLK-{ISBN13}-{YYYYMM} |
<ProductIdentifier> |
b.isbn |
Standard ISBN-13 (ProductIDType 15). |
<ProductForm> |
v.format |
Mapped ONIX form codes: BB (Hardback), BC (Paperback), EA (E-book), AJ (Audio). |
<TitleText> |
v.title |
Distinctive title of the book. |
<Contributor> |
v.author_name |
Primary author (ContributorRole A01). |
<SubjectHeadingText> |
b.category |
Bestseller category classification (SubjectSchemeIdentifier 20). |
<TextContent> |
b.logline |
Editorial logline / short annotation hook (TextType 02). |
<CitedContent> |
b.rank, b.timesonlist |
Contains list name, category position (<PositionOnList>), and cumulative months on list inside <CitationNote>. |
<PublishingDetail> |
v.imprint, b.pubdate |
Publishing imprint entity and publication release date (YYYYMMDD). |
<SupplyDetail> |
v.listprice |
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>
</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>01</CitedContentType>
<ContentAudience>00</ContentAudience>
<SourceType>01</SourceType>
<SourceTitle>AALBC BLK Bestsellers List</SourceTitle>
<ListName>Official AALBC Monthly BLK Bestsellers (Fiction)</ListName>
<PositionOnList>1</PositionOnList>
<CitationNote>Ranked #1 in Fiction for period 2026-08-01 on the AALBC BLK Bestsellers List. 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