API Documentation

Access your Glimpse competitive intelligence data programmatically. Use the API to integrate with Zapier, n8n, or your own tools.

Contents

Authentication
Rate limits
Errors
Signals
Competitors
Signal types

Base URL

https://www.glimpsehq.io/api/v1

All endpoints are relative to this base URL.

Authentication

All API requests require a valid API key sent as a Bearer token in the Authorization header.

Example request

curl https://www.glimpsehq.io/api/v1/signals \
  -H "Authorization: Bearer glmp_your_api_key_here"

Generate an API key in Settings > Integrations. Keys start with glmp_ and are shown once at creation.

Rate limits

API requests are limited to 20 requests per minute per API key. Exceeding this limit returns a 429 status code.

Parameter	Type	Required	Description
X-RateLimit-Limit	header	No	Max requests per window (20)
X-RateLimit-Remaining	header	No	Remaining requests in current window
Retry-After	header	No	Seconds until the rate limit resets (on 429 responses)

Errors

All errors return a JSON object with an error field.

Parameter	Type	Required	Description
401	status	No	Missing, malformed, or invalid API key
403	status	No	Subscription inactive or expired
404	status	No	Resource not found
429	status	No	Rate limit exceeded
500	status	No	Internal server error

Example error response

{
  "error": "Invalid API key"
}

Signals

GET/api/v1/signals- List signals across all competitors

Parameter	Type	Required	Description
competitor_ids	string	No	Comma-separated competitor UUIDs to filter by
types	string	No	Comma-separated signal types to filter by
limit	integer	No	Max results (default 50, max 500)
before	ISO 8601	No	Cursor for pagination - return signals before this timestamp
days	integer	No	Only return signals from the last N days

Example request

curl "https://www.glimpsehq.io/api/v1/signals?types=pricing_change,blog_post&days=7&limit=10" \
  -H "Authorization: Bearer glmp_your_api_key_here"

Response

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "type": "pricing_change",
      "title": "Acme Corp updated their pricing page",
      "summary": "Pro plan increased from $49/mo to $59/mo",
      "url": "https://acme.com/pricing",
      "severity": "alert",
      "published_at": "2026-04-10T08:00:00Z",
      "created_at": "2026-04-10T08:05:00Z",
      "competitor_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "competitor": {
        "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "name": "Acme Corp",
        "logo_url": null,
        "website": "https://acme.com"
      }
    }
  ],
  "has_more": false
}

GET/api/v1/competitors/{id}/signals- List signals for a specific competitor

Same parameters as above, minus competitor_ids.

Competitors

GET/api/v1/competitors- List all competitors

Parameter	Type	Required	Description
limit	integer	No	Max results (default 100, max 500)
offset	integer	No	Number of results to skip (default 0)

Response

{
  "data": [
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "Acme Corp",
      "website": "https://acme.com",
      "logo_url": null,
      "linkedin_url": "https://linkedin.com/company/acme",
      "twitter_url": "https://x.com/acme",
      "description": "Enterprise analytics platform",
      "created_at": "2026-01-15T10:00:00Z"
    }
  ],
  "total": 12
}

GET/api/v1/competitors/{id}- Get a single competitor

Response

{
  "data": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "name": "Acme Corp",
    "website": "https://acme.com",
    ...
  }
}

Signal types

Use these values with the types parameter to filter signals.

blog_postBlog post published

pricing_changePricing page updated

job_postingNew job listing

job_removedJob listing removed

tech_addedTechnology added to stack

tech_removedTechnology removed from stack

tech_stack_updateGeneral stack change

news_mentionMentioned in the news

newsletterNewsletter sent

ebookNew ebook or gated content

webinarWebinar recording

webinar_upcomingUpcoming webinar

linkedin_adLinkedIn ad detected

social_postSocial media post

youtube_videoYouTube video published

instagram_postInstagram post

facebook_postFacebook post

facebook_adFacebook ad detected

google_adGoogle ad detected

user_reviewUser review (G2, Capterra, etc.)

sitemap_updateWebsite sitemap changed

page_changeMonitored page changed

leadership_changeLeadership team update

Need help? Contact us at hello@glimpsehq.io