Zapier

​

Setup walkthrough

​

Prerequisites

• A Context.dev API key.
• A Zapier account with access to the apps and steps used in your workflow.
• A Google Sheet with domain and company_name columns. Add a test row containing stripe.com in the domain column.

​

1. Connect your account

​

2. Add a trigger

​

3. Get the company profile

​

4. Map and publish

​

Map the response

​

What you get

​

Request options

• Lists are plain text. Fields such as URLs, Tags, Publisher Domains, and Only These Domains take comma-separated values or one value per line.
• Maximum Cache Age (Milliseconds) controls how old a cached result may be. Leave it blank for the endpoint default. Brand retrieval and supported scraping operations accept 0 for a fresh fetch and honor positive values below one day.
• Country takes a two-letter code such as US or GB and fetches the page as a visitor from that country would see it.
• Zero Data Retention bypasses shared caches and keeps request content out of retained logs. It only works once zero data retention is enabled for your organization; otherwise the step fails with ZDR_NOT_ENABLED. See Zero Data Retention.
• Free and disposable emails are rejected. Get Brand Profile with Lookup By set to email returns a 422 for addresses at Gmail, Yahoo, and similar providers, or at disposable-email domains.
• Keep single-step crawls small. Crawl a Website and Extract Structured Data run inside one Zap step. For whole sites, use Submit Website Crawl Batch and pick the results up with the Batch Finished trigger.
• Include Page Content costs extra. In Search the Web, turning it on returns cleaned page content with each result and uses additional credits on top of the search.

​

Upgrading from the retired actions

​

Common trigger pairings

​

Sample response

{
  "status": "ok",
  "code": 200,
  "brand": {
    "domain": "loom.com",
    "title": "Loom",
    "logos": [],
    "colors": [],
    "socials": [
      { "type": "linkedin", "url": "https://linkedin.com/company/useloom" },
      { "type": "x", "url": "https://x.com/loom" }
    ]
  }
}

​

Reshape responses with Code by Zapier

import json

status = input_data.get("status", "")
brand = json.loads(input_data.get("brand") or "{}")

logos   = brand.get("logos", []) or []
colors  = brand.get("colors", []) or []
socials = brand.get("socials", []) or []
links   = brand.get("links", {}) or {}
stock   = brand.get("stock", {}) or {}
address = brand.get("address", {}) or {}
eic     = (brand.get("industries") or {}).get("eic") or []

socials_by_type = {s.get("type", "").lower(): s.get("url", "") for s in socials}
light_logo = next((l.get("url") for l in logos if l.get("mode") == "light"), None)
icon_logo  = next((l.get("url") for l in logos if l.get("type") == "icon"), None)

output = {
    "company_name":  brand.get("title", ""),
    "domain":        brand.get("domain", ""),
    "description":   brand.get("description", ""),
    "logo_url":      light_logo or (logos[0].get("url") if logos else ""),
    "icon_url":      icon_logo or "",
    "primary_color": colors[0].get("hex", "") if colors else "",
    "linkedin":      socials_by_type.get("linkedin", ""),
    "twitter":       socials_by_type.get("x", ""),
    "industry":      eic[0].get("industry", "") if eic else "",
    "subindustry":   eic[0].get("subindustry", "") if eic else "",
    "ticker":        stock.get("ticker", "") or "",
    "city":          address.get("city", "") or "",
    "country_code":  address.get("country_code", "") or "",
    "pricing_url":   links.get("pricing", "") or "",
}
output["enrichment_ok"] = status == "ok" and bool(brand.get("title"))

import json

brand = json.loads(input_data.get("brand") or "{}")
logos = brand.get("logos") or []

def find(type_, mode):
    return next((l.get("url") for l in logos
                 if l.get("type") == type_ and l.get("mode") == mode), None)

output = {
    "logo_light": find("logo", "light"),
    "logo_dark":  find("logo", "dark"),
    "icon_light": find("icon", "light"),
    "icon_dark":  find("icon", "dark"),
    "logo_any":   logos[0].get("url") if logos else None,
}

import json

status = input_data.get("status", "")
brand = json.loads(input_data.get("brand") or "{}")

output = {
    "enrichment_ok": status == "ok" and bool(brand.get("title")),
    "status":        status,
    "has_logo":      bool(brand.get("logos")),
    "has_industry":  bool((brand.get("industries") or {}).get("eic")),
    "company_name":  brand.get("title", ""),
}

​

Start Zaps from Context.dev events

​

Website change alerts

1. Create the monitor in the dashboard or with the Create Website Monitor action. Give it a tag such as competitors so you can filter on it later.
2. Trigger: Context.dev “New Website Change”. Set Monitor ID to watch one monitor, or leave it blank and set Tags to competitors to watch a group.
3. Action: Slack “Send Channel Message” with the change summary, the monitor name, and the target URL.

​

Batch pipeline

1. Trigger: Google Sheets “New Spreadsheet Row” with a domain column
2. Action: Context.dev “Submit Website Crawl Batch” with Source Type set to sitemap, Start URL or Domain mapped from the row, Output Format set to markdown, and Tags set to sheet-import

1. Trigger: Context.dev “Batch Finished” with Final Status set to completed and Tags set to sheet-import
2. Action: Context.dev “Get Batch Results” with the Batch ID from the trigger and Results Per Page set to 100
3. Looping by Zapier: Iterate over the result records
4. Action: Airtable “Create Record” per page with its URL, title, and Markdown

​

Reach endpoints without a dedicated action

1. Trigger: HubSpot “New Contact”
2. Action: Webhooks by Zapier “Custom Request”
   • Method: POST
   • URL: https://api.context.dev/v1/people/enrich
   • Data: {"email": "<contact email from step 1>"}
   • Headers: Authorization: Bearer ctxt_secret_... and Content-Type: application/json
3. Action: HubSpot “Update Contact” with the returned title, company, and social profiles

​

Example automations

​

Troubleshooting

• “Authentication failed.” The API key was rejected. Re-paste it in Zapier’s My Apps > Context.dev connection settings; confirm the ctxt_secret_ prefix.
• Get Brand Profile returns 422 on an email. The address is at a free provider (Gmail, Yahoo, and similar) or a disposable-email domain. Filter those out before the Context.dev step, or switch Lookup By to company name or domain.
• A trigger never fires. Polling triggers only pick up events recorded after the Zap is turned on. Check that the monitor is active, that Monitor ID, Tags, or Final Status filters match, and that Zapier’s polling interval has elapsed. Batch Finished requires one Final Status, so make a separate Zap for each terminal status you care about.
• Create Website Monitor is rejected. Semantic page monitors and structured website monitors need Change Instructions, sitemap monitors only support exact change detection, and Run Every with Schedule Unit must land between 10 minutes and one year. See Pick a target.
• A crawl or extraction step times out. Lower Maximum Pages or Maximum Link Depth, or move the job to Submit Website Crawl Batch and read it back with Batch Finished and Get Batch Results.
• Parse a Document fails. File Extension is required and must match the file, written without a dot. Scanned PDFs need Use OCR turned on.
• A step fails with ZDR_NOT_ENABLED. Zero Data Retention is on but your organization has not enabled it. Turn the field off, or contact [email protected] to enable it.
• No logo in the response. Keep the company name visible and use your own initials or neutral icon when the destination needs an image. Logo Link can provide a hosted logo, but it also needs a missing-image fallback.
• An old Zap references a different action name. Compare the installed version with the migration table, then test the replacement before publishing.

​

Next steps