Take Midu Integrate into your Agent

Add to the news request category, only the corresponding category is used; if omitted, all categories are included. Returned items’ category also use the values in the table below.

1. 01
   Enable Compression

   curl add --compressed, other clients enable gzip or br. After JSON compression it’s only 1/4 to 1/8 of the original size.

2. 02
   Include ETag

   Save the ETag from the response and send it next time If-None-Match; return 304 when content is unchanged, without sending the body.

3. 03
   Fetch by cadence

   News and trending updated as often as once a minute; Midu Daily daily at 00:00 UTC fetch once after; fetch once after the Weekly and Monthly are published; when paging back, stop once you reach an existing item.

How often content changes: new items come in throughout the day, Top Deals change a few to dozens of times daily, Midu Daily daily at 00:00 UTC, Weekly every Monday at 02:00 UTC, Monthly at 02:30 UTC on the 1st of each month, one issue each.

# First time: save the ETag from the response headers
curl --compressed -i 'https://midu.si/api/v1/items?mode=selected&window=24h&limit=20'
# Then at most once a minute, sending the ETag; 304 means nothing changed
curl --compressed -i -H 'If-None-Match: <the previous ETag>' 'https://midu.si/api/v1/items?mode=selected&window=24h&limit=20'

When you need to page back, set page.nextCursor Pass it back as a cursor; stop when you reach an existing item, don’t re-fetch the last 7 days every time.

400

Invalid parameters: fix according to OpenAPI and the returned code, do not automatically switch to a broader query. If cursor is invalid or slides out of the time window, return invalid_cursor and restart from the first page.

409

snapshot_required: the incremental update can’t be safely resumed; fetch a full snapshot again.

429

Too many requests: wait according to Retry-After; do not retry concurrently.

5xx

Exponential backoff, use the last successful result first; public service does not promise an SLA.

Anonymous access does not mean all uses are permitted, seeUsage Rules.