String docs
Site integrations

Babylist

Babylist baby registries: a registry's summary (owner names, location, arrival date, item count) and its full item list with prices, retailers and purchase status, exactly as the public /list/<slug> page shows them.

Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.

  • Site: babylist
  • Version: 1.0.0
  • Reads from: www.babylist.com, my.babylist.com
ActionDescriptionListed price
registryRead a Babylist registry's summary: the registrant's names, location, arrival and shower dates, the couple's own note, and the item count, as the public registry page shows them.Billed per request at your plan's rates
itemsRead every wanted item on a Babylist registry: title, price, the retailer link, description, stock and delivery estimate, quantities needed, bought and reserved, and cash-fund goals with what they have raised so far.Billed per request at your plan's rates

registry

Read a Babylist registry's summary: the registrant's names, location, arrival and shower dates, the couple's own note, and the item count, as the public registry page shows them.

POST https://request.usestring.ai/v1/integrations/babylist/registry

Input

Unknown fields are rejected.

FieldTypeDescription
slugstringRequired. The registry: its Babylist slug, such as maya-liam, or a babylist.com/list/<slug> URL. At least 1 character.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
slugstringThe registry's Babylist slug.
urlstringThe registry's canonical babylist.com page.
titlestring | null—
ownerNamestring | nullThe registrant's display name.
firstNamesstring | nullThe couple's first names as the page joins them.
descriptionstring | nullThe couple's own note at the top of the page.
locationstring | nullThe city and state the registrant gave.
arrivalDatestring | nullThe due date as the page shows it.
showerDatestring | null—
showerGuestCountinteger | null—
photoUrlstring | null—
itemCountintegerThe number of items the registry reports.
passwordProtectedbooleanTrue when the page asks visitors for a password.

Example

curl https://request.usestring.ai/v1/integrations/babylist/registry \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "salayareign"
  }'

data starts with these rows:

[
  {
    "slug": "salayareign",
    "url": "https://my.babylist.com/salayareign",
    "title": "Jada's Baby Registry",
    "ownerName": "Jada Harris",
    "firstNames": "Jada",
    "description": null,
    "location": "Perry, GA",
    "arrivalDate": null,
    "showerDate": null,
    "showerGuestCount": null,
    "photoUrl": "https://images.babylist.com/image/upload/w_340,h_340,c_thumb,f_auto/v1790376179/wk1rvcaja9l3ipgrdteb.jpg",
    "itemCount": 253,
    "passwordProtected": false
  }
]

Requests and billing

  • Requests: 1 Web Access request per call.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

items

Read every wanted item on a Babylist registry: title, price, the retailer link, description, stock and delivery estimate, quantities needed, bought and reserved, and cash-fund goals with what they have raised so far.

POST https://request.usestring.ai/v1/integrations/babylist/items

Input

Unknown fields are rejected.

FieldTypeDescription
slugstringRequired. The registry: its Babylist slug, a babylist.com/list/<slug> URL or a my.babylist.com/<slug> URL. At least 1 character.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
positionintegerThe item's place on the list, from 1.
titlestring—
pricenumber | nullThe item's price in dollars.
urlstring | nullThe retailer product URL the registry links to.
descriptionstring | null—
imageUrlstring | null—
availabilitystring | nullStock as the page shows it, such as InStock.
deliveryEstimatestring | nullThe delivery window the page shows.
quantityNeededinteger—
quantityPurchasedintegerHow many are already bought.
quantityReservedintegerHow many someone has claimed.
purchasedbooleanTrue once the item is fully bought.
reservedbooleanTrue once every needed unit is claimed.
cashFundbooleanTrue for a cash goal, not a product.
groupGiftbooleanTrue when the item takes contributions from several givers.
favoritebooleanThe registrant marked it a top pick.
goalAmountnumber | nullA cash fund's target in dollars.
fundedAmountnumber | nullWhat the cash fund has raised so far, in dollars.
retailersstring[] | nullEvery retailer the registry price-compares this item across.

Example

curl https://request.usestring.ai/v1/integrations/babylist/items \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "salayareign"
  }'

data starts with these rows:

[
  {
    "position": 1,
    "title": "Womens Seamless Nursing Bra Sleeping Maternity Bralette for Breastfeeding Pack of 3",
    "price": 29.99,
    "url": "https://www.amazon.com/dp/B07BKVJNLC",
    "description": "",
    "imageUrl": "https://images.babylist.com/image/upload/f_auto,q_auto:best/jxtx82hq0ut63nkemqza.jpg",
    "availability": "InStock",
    "deliveryEstimate": "Thursday Nov 19 - Wednesday Nov 25",
    "quantityNeeded": 1,
    "quantityPurchased": 0,
    "quantityReserved": 0,
    "purchased": false,
    "reserved": false,
    "cashFund": false,
    "groupGift": false,
    "favorite": false,
    "goalAmount": 0,
    "fundedAmount": 0,
    "retailers": ["Amazon"]
  },
  {
    "position": 2,
    "title": "Baby Brezza Baby Bottle Washer Pro - Clinically Proven Better Cleaning | Washer, Sterilizer + Dryer for Essentials like Bottles + Pump Parts – Machine Replaces Brushes + Racks, HEPA Filter",
    "price": 299.99,
    "url": "https://www.babylist.com/gp/baby-brezza-bottle-washer-pro/44961/1738393",
    "description": "",
    "imageUrl": "https://images.babylist.com/image/upload/f_auto,q_auto:best/odlq5wgcygbqsaguswab.jpg",
    "availability": "InStock",
    "deliveryEstimate": "Tuesday Nov 17 - Wednesday Nov 25",
    "quantityNeeded": 1,
    "quantityPurchased": 0,
    "quantityReserved": 0,
    "purchased": false,
    "reserved": false,
    "cashFund": false,
    "groupGift": false,
    "favorite": false,
    "goalAmount": 0,
    "fundedAmount": 0,
    "retailers": ["Babylist"]
  },
  {
    "position": 3,
    "title": "Baby Brezza Formula Pro Advanced Formula Dispenser + Bottle Maker Machine | At the Touch of a Button - Automatically Mix a Warm Formula Bottle Instantly - Easily Made Bottles with Auto Powder Blending",
    "price": 229.99,
    "url": "https://www.amazon.com/dp/B07MYW28QR",
    "description": "",
    "imageUrl": "https://images.babylist.com/image/upload/f_auto,q_auto:best/jrposndkd9eq8howu9av.jpg",
    "availability": "InStock",
    "deliveryEstimate": "Tuesday Nov 17 - Wednesday Nov 25",
    "quantityNeeded": 1,
    "quantityPurchased": 0,
    "quantityReserved": 0,
    "purchased": false,
    "reserved": false,
    "cashFund": false,
    "groupGift": false,
    "favorite": false,
    "goalAmount": 0,
    "fundedAmount": 0,
    "retailers": ["Babylist", "Amazon"]
  }
]

Requests and billing

  • Requests: 1 Web Access request per call.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.