{"uid":"cap_Vsbd9QUvCOWrFxJ_4oTFO","slug":"yodeler-news-feed-api-c62fd3d8","name":"Yodeler News Feed API","description":"Forwarded news data from the Yodeler database. Price is computed from the actual billable row count and requested recency. Use /v1/news/availability to preview whether the query is free before paying.","url":"https://x402.yodeler.xyz/v1/news","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","default":50,"maximum":500,"minimum":1,"description":"Maximum batch size to price and return."},"since":{"type":"string","format":"date-time","description":"Optional lower-bound timestamp for freshness-aware pricing."},"channel":{"type":"integer","description":"Optional Telegram source channel id filter."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"meta":{"sort":"created_at_desc","limit":200,"since":"2026-05-01T12:00:00Z","channel":123,"is_free":false,"has_more":true,"quote_id":"news_5f25b7aab0f8c302","next_cursor":"eyJjcmVhdGVkX2F0IjoiMjAyNi0wNS0wMVQxMjowMDowMCswMDowMCIsImlkIjoiMDE5NjFjMWItY2Y2Zi03N2VjLWI2NmQtYzZlZjI4MTlkZDg2In0","pricing_hash":"5f25b7aab0f8c3029c9a7e708c0f2cb0ad3c8f7d12253ec48f0f3e927af1cc19d","delivery_mode":"paid","billable_count":180,"available_count":180},"count":1,"items":[{"id":"01961c1b-cf6f-77ec-b66d-c6ef2819dd86","source_id":123,"created_at":"2026-05-01T12:00:00Z","message_text":"Breaking news: Yodeler forwarded another headline.","destination_id":456,"destination_type":"telegram"}],"window":{"newest_created_at":"2026-05-01T12:00:00Z","oldest_created_at":"2026-05-01T12:00:00Z"},"payment":{"asset":"0x833589fCD6EDb6E08f4c7C32D4f71b54bdA02913","price":"$0.01","amount":"10000","pay_to":"0x1111111111111111111111111111111111111111","scheme":"exact","network":"eip155:8453","currency":"USD"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4EInx5UUYUpRR-cP2NTGm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns paginated news items from the Yodeler database, priced dynamically based on row count and recency of the requested data.","exampleAgentPrompt":"Pull up to 100 news items from Yodeler published since January 1st, 2025 — filter to Telegram channel 1234567 if possible.","exampleUseCases":[{"title":"Monitor breaking news from a channel","prompt":"Give me the last 50 news items from Yodeler's feed for Telegram channel 987654321, published since yesterday."},{"title":"Bulk news export for analysis","prompt":"Fetch 500 news records from Yodeler going back to March 1st, 2025 so I can analyze coverage trends."},{"title":"Check freshness before paying","prompt":"Get me the 20 most recent news items from Yodeler's database — anything posted in the last 6 hours."}],"resultDescription":"A list of news records from the Yodeler database, up to the requested limit, optionally filtered by timestamp and Telegram source channel. Each record reflects actual billable rows, and pricing scales with the number of rows returned and their recency.","failureModes":["No results returned if the 'since' timestamp is too recent and no data exists in that window","Payment required (402) if the query is not free — use /v1/news/availability to preview cost first","Invalid channel ID returns empty result set or error","Limit exceeding 500 rejected with validation error","Malformed date-time format for 'since' parameter causes schema validation failure"],"whenToPreferThis":"Use this endpoint when you need to retrieve raw news records from the Yodeler database, especially when filtering by recency or Telegram source channel. It is ideal for agents that need freshness-aware, pay-per-use news data with dynamic pricing. Check /v1/news/availability first if you want to preview whether a given query will be free before committing payment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:31:22.781Z","isFirstParty":false}