{"uid":"cap_eRsnt3ukKBMGjqswgGcKS","slug":"fastx402-lab-natural-language-date-parser-6abb23a5","name":"FastX402 Lab – Natural Language Date Parser","description":"200 pay-per-call tools for AI agents, from $0.001 per request in USDC on Base or Solana with x402. No account, no API key.","url":"https://fastx402.tools/date-parse-natural?utm_source=zero.xyz","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"],"type":"string"},"queryParams":{"type":"object","required":["text","reference"],"properties":{"text":{"type":"string","description":"Text with a date, e.g. next friday at 5pm"},"reference":{"type":"string","description":"Reference time (usually now), ISO 8601"},"tz_offset":{"type":"string","description":"The writer's UTC offset in minutes, e.g. 180 for Istanbul (default 0)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"end":{"type":"null"},"text":{"type":"string"},"start":{"type":"string"}}}},"reference":{"type":"string"},"tz_offset":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"results":[{"end":null,"text":"next friday at 5pm","start":"2026-10-23T17:00:00.000Z"}],"reference":"2026-10-18T10:00:00.000Z","tz_offset":0}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5jUsRWBUnowu2AXgPGGnd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Parses natural-language date/time expressions (e.g. 'next friday at 5pm', 'in 3 days') into exact ISO 8601 timestamps, relative to a given reference time and UTC offset.","exampleAgentPrompt":"The user wrote 'next friday at 5pm' — can you convert that to an exact UTC timestamp? My current time is 2026-10-18T10:00:00.000Z and I'm in UTC+3 (180 minutes offset).","exampleUseCases":[{"title":"Scheduling assistant parses user input","prompt":"A user just typed 'let's meet in 3 days at noon' — can you figure out the exact UTC date and time that means? Right now it's 2026-10-18T09:00:00Z and the user is in UTC+2 (120 minutes offset)."},{"title":"Calendar event from freeform message","prompt":"Someone said they want a reminder 'tomorrow morning at 9am' — can you parse that into a precise timestamp? The reference time is 2026-10-18T14:00:00.000Z and they're in UTC-5 (-300 minutes offset)."},{"title":"Deadline extraction from task description","prompt":"A task card says 'due end of next week Friday at 6pm' — can you tell me the exact ISO timestamp for that deadline? Use 2026-10-19T08:00:00.000Z as now, UTC+0."}],"resultDescription":"Returns a JSON object with a 'results' array where each item contains the matched text span, a 'start' ISO 8601 timestamp, and an 'end' ISO 8601 timestamp (null for point-in-time expressions). Also echoes back the reference time and UTC offset used.","failureModes":["Ambiguous date text with no clear resolution returns an empty results array","Missing or malformed reference time causes a 400 error","Invalid tz_offset value (non-numeric or out of range) may produce incorrect timestamps","Highly context-dependent expressions (e.g. 'the usual time') return no results","Non-date text passed in 'text' parameter returns empty results array"],"whenToPreferThis":"Use this endpoint when users type freeform natural language dates or relative time expressions that need to be converted to machine-readable ISO 8601 timestamps. Ideal for scheduling agents, calendar tools, task managers, and reminder systems that need to interpret what humans write without assuming a fixed date format. Prefer it over regex-based parsers or LLM self-resolution when you need deterministic, timezone-aware parsing with a clear reference time anchor.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-20T06:51:13.495Z","isFirstParty":false,"canonicalSlug":"fastx402-lab-natural-language-date-parser-6abb23a5"}