Migrate from BigPicture to SavvyIQ
Cutoff: August 30, 2026
BigPicture endpoints (company.bigpicture.io) stop accepting requests after this date.
Why migrate
- More accurate business data. BigPicture matched by domain, so company size, revenue, and industry frequently came back wrong (e.g., Google has thousands of domains; small businesses on shared hosting hit the same problem). SavvyIQ resolves to the legal entity first, then attaches data.
- Real industry classification. NAICS codes with confidence scoring, not a flat tag list. The most-requested BigPicture feature.
- Corporate hierarchy. Parent and subsidiary relationships. Not available in BigPicture.
- Stable entity IDs. One record per business, queried by ID instead of by URL.
- Same throughput. 600 requests/minute.
Pricing and migration support
- Pricing matched. Your BigPicture rate is honored on SavvyIQ for 90 days after you migrate. After that, pricing is based on usage. Contact sales to discuss tiers.
- Migration credits. Free credits available to cover testing and any data-parity issues during cutover. Ask support.
- Parallel run supported. Both APIs accept traffic today. Run them side by side during cutover and compare responses. Your BigPicture key works until August 30, 2026.
- Time to migrate. Most integrations complete the port in under an hour.
What changes
- Base URL.
company.bigpicture.io→api.savvyiq.ai - Auth header.
Authorization: keyId:keySecret→apikey: TOKEN(lowercase) - Flow. 1 call → 2 calls (resolve, then fetch full record)
- Webhooks. Coming soon. Use polling until then.
- Response shape. Different field paths.
Endpoint mapping
| BigPicture | SavvyIQ |
|---|---|
GET /v1/companies/find | GET /v1/domain-intelligence |
GET /v1/companies/find/stream | GET /v1/domain-intelligence |
GET /v2/companies/search | GET /v2/entity-resolution/async + GET /v2/entity-resolution/status/{id} |
GET /v2/companies/ip | No equivalent. Contact us. |
For full business data after step 1, call GET /v1/entities/{entity_id}.
Authentication
- Sign up at savvyiq.ai/signup.
- Generate a key at app.savvyiq.ai/api-keys.
- Send it on every request:
Loading...Step 1: Resolve
By domain
Poll /v1/domain-intelligence until status is complete. Returns a siq_ entity ID for step 2.
Loading...By name
Submit, then poll. Returns a siq_ entity ID.
Loading...Step 2: Get the full business record
Pass the siq_ entity ID to /v1/entities/{id}. Returns name, headquarters, classification, attributes, financials. Cached entities return instantly. New entities take 2-5 minutes.
Loading...Full schema: Business Intelligence API reference. For large batches, persist request_ids and entity IDs and poll out-of-band rather than blocking. See Batch Processing.
Response shape
The full entity record from step 2 covers what BigPicture customers asked for most: industry classification, employee count, revenue, plus extras like founding date, market cap, funding raised, and social handles.
| BigPicture | SavvyIQ |
|---|---|
name | data.name |
legalName | data.primary_legal_entity.name |
domain | data.attributes.domain |
url | data.attributes.website |
description | data.attributes.description |
foundedYear | data.attributes.founding_date (YYYY-MM-DD) |
geo.* | data.headquarters.address.* |
tags | data.classification.business_tags[] |
category.* (incl. naicsCode) | data.classification.naics_codes_2022[], data.classification.sic_codes[] (with confidence) |
metrics.employees, metrics.employeesRange | data.attributes.employee_count, data.attributes.employee_range |
metrics.annualRevenue, metrics.estimatedAnnualRevenue | data.attributes.revenue, data.attributes.revenue_range |
metrics.marketCap | data.attributes.market_cap |
metrics.raised | data.attributes.funding_total_usd |
ticker | data.attributes.stock_ticker |
type (public/private) | data.attributes.is_public |
linkedin.handle, facebook.handle, twitter.handle, crunchbase.handle | data.social_profiles.{linkedin,facebook,twitter,crunchbase}.handle |
logo, phone, tech, alexa*Rank, trancoRank | Not returned |
Industry classification uses NAICS and SIC codes with confidence scoring instead of flat strings. Full schema: Business Intelligence reference.
Side by side, step 1: domain intelligence
Resolution plus first-pass classification. The BigPicture column shows the subset of /v1/companies/find fields that map to this SavvyIQ step. Real responses, abridged.
Loading...The SavvyIQ response includes the legal entity (GOOGLE LLC, Delaware), confidence-scored NAICS codes, and an entity.id (siq_…) you pass to step 2. BigPicture returns a single flat blob with a single NAICS code (5112, broader than SavvyIQ's specific match).
Side by side, step 2: business intelligence
Company size, revenue, deep classification, social handles. The BigPicture column shows the fields from the same /v1/companies/find response that map to the SavvyIQ entity record.
Loading...The diff is concrete. For the same google.com lookup, BigPicture returned employees: null, annualRevenue: null, marketCap: null, foundedYear: 2015 (Google was founded in 1998), crunchbase.handle: "organization/launchpad-accelerator" (not Google's profile). SavvyIQ returned employee_count: 10001, revenue: 256700000000, founding_date: "1998-09-04", crunchbase.handle: "google".
Errors
// 400, 500, 502
{ "error": { "message": "...", "type": "bad_request" } }
// 401
{ "message": "No API key found in request", "request_id": "..." }| Status | Meaning |
|---|---|
| 400 | Bad parameter. Do not retry. |
| 401 | Bad or missing API key. |
| 404 | Entity not found. |
| 429 | Rate limited. Back off. |
| 500 | Server error. Retry with backoff. |
| 502 | Upstream timeout. Retry. |
Rate limits
600 requests/minute per account. Headers on every response:
X-RateLimit-Limit-MinuteX-RateLimit-Remaining-Minute
Parity gaps
- Webhooks. Coming soon. Per-request
webhookUrl/webhookIdcallbacks are not yet supported. Use polling. - IP lookup. No equivalent. Contact us.
Dashboard
Keys, usage, and billing: app.savvyiq.ai.
FAQ
Will my BigPicture API key keep working until the cutoff?
Yes. company.bigpicture.io accepts requests until August 30, 2026.
Can I run BigPicture and SavvyIQ in parallel? Yes. Both APIs accept traffic today. Compare responses side by side during cutover.
Will my pricing change? Your BigPicture rate is honored on SavvyIQ for 90 days after you migrate. After that, pricing depends on usage volume. Contact sales.
Are migration credits available? Yes. Email support to request credits for testing and any data-parity issues during cutover.
How long does the migration take? Under an hour for most integrations. Half a day if you have many call sites or complex response parsing.
How do I report a migration issue? Email support with your BigPicture account ID, the endpoint you're porting, and a sample request/response pair.
Will the SavvyIQ API change again soon? No breaking changes to the endpoints in this guide are planned. Email support to be notified of future changes.
Need help
Email support if anything blocks your migration.