René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Add geography/location filters to Monitor API (`/v1alpha/monitors`)","articleBody":"## Summary\nThe Monitor API currently has no way to scope queries by geography or location. The public docs for `POST /v1alpha/monitors` list only `query`, `cadence`, optional `webhook`, and `metadata`, but no geo-related fields. We need a way to monitor specific regions.\n\n## Current Behavior\n- SDK (`parallel-sdk-python`) doesn’t expose any geo/location parameters.\n- Live docs (https://docs.parallel.ai/api-reference/monitor/create-monitor) confirm no geo fields.\n- Workaround today is to bake location terms into the query string, which is brittle and limits filtering.\n\n## Desired Behavior / Proposal\nExpose geography controls when creating and managing monitors. For example:\n- Allow specifying one or more regions (country, state/province, city, lat/lon + radius, etc.).\n- Persist the geo settings so subsequent monitor executions restrict to those regions.\n- Mirror the new fields in client SDKs (Python, TypeScript).\n\n## Rationale\n- Many use cases (market intelligence, risk monitoring, compliance) require geo-scoped monitoring.\n- Location filters reduce noise and API usage by eliminating irrelevant results.\n- Competitors typically support region filters; parity helps adoption.\n\n## Alternatives Considered\n- Encoding location constraints into the `query` string — unreliable and does not guarantee geo precision.\n- Post-filtering results – infeasible unless the service includes rich location metadata, and still wastes monitor executions.\n\n## Additional Context\nUsing `parallel-sdk-python` client:\n```python\ngroup = client.get(\n    f\"/v1alpha/monitors/{monitor_id}/event_groups/{event_group_id}\",\n    cast_to=httpx.Response,\n).json()\n```\nNo metadata in the response indicates where events originated, so client-side geo filtering is not practical.\n\nWould love guidance on planned support or required schema changes so we can contribute.","author":{"url":"https://github.com/Krishna2709","@type":"Person","name":"Krishna2709"},"datePublished":"2025-11-15T02:32:41.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":0},"url":"https://github.com/19/parallel-sdk-python/issues/19"}