SpyFu
New RivalFlow AI

Improve Existing Content with AI

RivalFlow spots gaps in your existing SEO content and generates high-ranking content to fill them.

Documentation Powered by ReDoc

Domain Lists and Leads API Documentation (v1)

Create a targeted list of domains using any number of filters: Location, Industry, Adword Budget, Search Engine Traffic, Social Media Presense, and more.

Authentication

Authentication

Basic Auth Token

Security scheme type: HTTP
HTTP Authorization Scheme basic

api_key

Secret Key Authentication

Security scheme type: API Key
Query parameter name: api_key

LeadsApi

Search and retrieve leads data by domains, industry, technology, and other advanced filters.

Get list of contacts for a domain

get /get_contact_card
https://www.spyfu.com:80/apis/leads_api/get_contact_card
query Parameters
domain
required
string

Domain query

api_key
string

User's secret key

Responses

200

OK

204

Domain does not exist

500

InternalServerError

Request samples

Copy
curl "https://www.spyfu.com/apis/leads_api/get_contact_card?domain=spyfu.com&api_key=SECRET_KEY"

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "address": "",
  • "attrib_crunchbase": "",
  • "attrib_gplus": "",
  • "attrib_linkedin": "",
  • "blog": "www.spyfu.com/blog/",
  • "city": "Scottsdale",
  • "company": "SpyFu Inc.",
  • "company_id": "",
  • "domain_age": 0,
  • "domain_id": "-8280301796433908807",
  • "emails": "sales@spyfu.com,support@spyfu.com,supremedeveloperjob@spyfu.com",
  • "facebook": "https = //www.facebook.com/SpyFu",
  • "fields": "domain_id site num_ppc_kw num_seo_kw ppc_clicks seo_clicks ppc_budget seo_value company company_search full_address city city_search state state_search zip metro is_hq location_search industry_linkedin industry_crunchbase industry_spyfu industry_search top_ppc_keywords top_seo_keywords keyword_search num_employees_min num_employees_max ownership_type blog phones area_code emails twitter facebook youtube linkedin gplus tech_types technologies other_domains_owned other_domains_owned_type categories tags is_good_contact",
  • "full_address": "Scottsdale, AZ 85260",
  • "gplus": "https = //plus.google.com/111706927542999352409/posts",
  • "industry_crunchbase": "Advertising",
  • "industry_linkedin": " Marketing and Advertising",
  • "industry_search": " Marketing and Advertising",
  • "industry_spyfu": "Marketing",
  • "is_hq": "True",
  • "linkedin": "https = //www.linkedin.com/company/spyfu",
  • "location_id": "",
  • "location_url": "",
  • "metro": "Phoenix, AZ",
  • "neighborhood": "",
  • "num_employees_max": 15,
  • "num_employees_min": 10,
  • "num_ppc_kw": 2364,
  • "num_seo_kw": 18660,
  • "ownership_type": "Privately Held",
  • "phones": "888-201-0422",
  • "pinterest": "",
  • "ppc_age": 0,
  • "ppc_budget": 18554.526,
  • "ppc_clicks": 7576.65640246242,
  • "relatedDomains": null,
  • "review_urls": "",
  • "seo_age": 0,
  • "seo_clicks": 888565.33845538,
  • "seo_value": 932683.751306656,
  • "site": "spyfu.com",
  • "state": "AZ",
  • "tech_types": "Analytics,Content Delivery Networks,Document Info,Email Hosters,Encoding,JavaScript,Name Servers,Web Frameworks,Web Server,Widgets",
  • "technologies": "Cascading Style Sheets,CloudFront,Conditional Comments,Fancybox,GoDaddy DNS,Google Analytics,Google Chrome Frame Popup,Google Chrome IE Frame,Google Postini Services,Hover Intent,HTML 5 Specific Tags,HTML5 DocType,IIS,Javascript,Javascript Defer,jQuery,jQuery UI,KISSmetrics,MailChimp SPF,Modernizr,UserVoice,UTF-8,Viewport Meta,Visual Website Optimizer,Web of Trust,X-UA-Compatible",
  • "top_ppc_keywords": null,
  • "top_seo_keywords": null,
  • "twitter": "@spyfu",
  • "youtube": "https = //www.youtube.com/user/SpyFuTeam",
  • "zip": 85260,
  • "message": null,
  • "success": false,
  • "redirect_url": null,
  • "resultCount": 0
}

Get list of contact leads

get /get_grid
https://www.spyfu.com:80/apis/leads_api/get_grid
query Parameters
q
string

Search query

r
integer <int32>

Maxinum number of rows

locationAndFacet
string

Required locations CSV

locationOrFacet
string

Optional locations CSV

adBudgetFacet
string

Ad budget range: [Min# to Max#]

seoClickFacet
string

SEO click range: [Min# to Max#]

contactFacet
string

Required contact types CSV

includeTechFacet
string

Required technologies CSV

excludeTechFacet
string

Excluded technologies CSV

includeIndFacet
string

Required industries CSV

excludeIndFacet
string

Excluded industries CSV

sicFacet
string

Standard Industrial Classifications CSV

naicFacet
string

North American Industry Classifications CSV

api_key
string

User's secret key

Responses

200

OK

500

InternalServerError

Request samples

Copy
curl "https://www.spyfu.com/apis/leads_api/get_grid?api_key=SECRET_KEY"

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "contacts":
    [
    • {
      • "adBudget": 0,
      • "domainId": "-8862477046489936655",
      • "domainName": "a-automotive.com",
      • "hasEmail": false,
      • "hasFacebook": false,
      • "hasGooglePlus": false,
      • "hasLinkedIn": false,
      • "hasLocation": true,
      • "hasPhone": true,
      • "hasPinterest": false,
      • "hasTwitter": false,
      • "hasYouTube": false,
      • "seoClicks": 0.79471483528902
      },
    • {
      • "adBudget": 0,
      • "domainId": "-8370767109396854491",
      • "domainName": "automotive-advertising.co",
      • "hasEmail": false,
      • "hasFacebook": true,
      • "hasGooglePlus": false,
      • "hasLinkedIn": false,
      • "hasLocation": false,
      • "hasPhone": false,
      • "hasPinterest": true,
      • "hasTwitter": true,
      • "hasYouTube": false,
      • "seoClicks": 0
      }
    ],
  • "numberPages": 1436,
  • "numberResults": 28702,
  • "message": null,
  • "success": true,
  • "redirect_url": null,
  • "resultCount": 20
}

Get top list of domains for a given category

get /get_top_list
https://www.spyfu.com:80/apis/leads_api/get_top_list
query Parameters
listType
required
string

Type of list to request: (Top-Adwords, Top-Organic, With-Email, With-Phone, With-Social, Sales-Leads, Organic-Twitter, No-Social, No-Blog)

r
required
integer <int32>

Maxinum number of rows

state
string

State

city
string

City

zip
string

Zip code

tech
string

Type of technology to include: (A/B Testing, Ad Buying Platform, Ad Retargeting, Ad Serving Platform, Ads, Affiliate Management Platform, Affiliate Marketing Links, Commerce Platform, Consumer Data, Content Management System, CRM, Development Tools, Email Marketing, Forums, Hit Counter, Image Gallery, Infrastructure / OS, Internet Marketing Platform, Live Chat, Old, Payment Processor, Programming Language, Security, Shopping Cart, Site Components, Site Performance, Social Analytics, Social Media, Social Share Buttons, Surveys, Tag Management, Trust, User Feedback, Video Hosting, Video Player, Visitor Identification, Voice / Phone, Web Analytics, Web Server)

industry
string

Type of industry to include: (Medical, Legal, Insurance, Loans)

api_key
string

User's secret key

Responses

200

OK

500

InternalServerError

Request samples

Copy
curl "https://www.spyfu.com/apis/leads_api/get_top_list?listType=Top-Adwords&r=10&state=Arizona&city=Scottsdale&zip=&tech=Ads&industry=Insurance&api_key=SECRET_KEY"

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    • "adBudget": 8900.064,
    • "domainName": "envita.com",
    • "seoClicks": 25081.460944827
    },
  • {
    • "adBudget": 5096.799,
    • "domainName": "myfaceandbody.com",
    • "seoClicks": 36.2731463114767
    },
  • {
    • "adBudget": 4010.928,
    • "domainName": "outofcourtsolutions.com",
    • "seoClicks": 88.9764545510881
    }
]