Overview

The Batch Process endpoint allows you to batch several API requests into a single request to improve performance by eliminating excess network overhead. This endpoint will proxy requests (up to 20 per batch) on your behalf to any other API endpoint which accepts GET requests.

Requests

JSON

curl -H"X-FullContact-APIKey:$your_key" 'https://api.fullcontact.com/v2/batch.json'

To use this endpoint, you must POST a list of API requests which you would like batched together, sending a request Content-Type of "application/json".

Example POST Request

POST /v2/batch.json?apiKey=[your API key] HTTP/1.1
Content-type: application/json
Host: api.fullcontact.com
Content-Length: 236
Connection: Keep-Alive

{
    "requests" : [
        "https://api.fullcontact.com/v2/name/normalizer.json?q=dan+lynn",
        "https://api.fullcontact.com/v2/name/normalizer.json?q=kyle+hansen",
        "https://api.fullcontact.com/v2/person.json?email=bart@fullcontact.com"
    ]
}

Responses

The API responds with JSON.

JSON

{
  "status": 200,
  "responses": {
    "https://api.fullcontact.com/v2/name/normalizer.json?q=dan+lynn": {
      "region": "USA",
      "nameDetails": {
        "nicknames":
        [
        ],
        "suffixes":
        [
        ],
        "familyName": "Lynn",
        "fullName": "Dan Lynn",
        "givenName": "Dan",
        "prefixes":
        [
        ],
        "middleNames":
        [
        ]
      },
      "status": 200,
      "likelihood": 0.974
    },
    "https://api.fullcontact.com/v2/name/normalizer.json?q=kyle+hansen": {
      "region": "USA",
      "nameDetails": {
        "nicknames":
        [
        ],
        "suffixes":
        [
        ],
        "familyName": "Hansen",
        "fullName": "Kyle Hansen",
        "givenName": "Kyle",
        "prefixes":
        [
        ],
        "middleNames":
        [
        ]
      },
      "status": 200,
      "likelihood": 1
    },
    "https://api.fullcontact.com/v2/person.json?email=bart@fullcontact.com": {
      "photos":
      [
        {
          "typeName": "Twitter",
          "type": "twitter",
          "typeId": "twitter",
          "url": "http://a0.twimg.com/profile_images/1364842224/Bart_Profile_1_normal.jpg"
        },
        {
          "typeName": "Twitter",
          "type": "twitter",
          "typeId": "twitter",
          "url": "http://a2.twimg.com/profile_images/642635573/ForsetiAvatar_normal.png"
        },
        {
          "typeName": "Tungle Me",
          "type": "tungleme",
          "typeId": "tungleme",
          "url": "https://tungle.me/public/bartlorang/Image"
        },
        {
          "typeName": "Plancast",
          "type": "plancast",
          "typeId": "plancast",
          "url": "http://plancast.com/uploads/pics/44636_pic_1314224723.jpg"
        },
        {
          "typeName": "Plancast",
          "type": "plancast",
          "typeId": "plancast",
          "url": "http://plancast.com/uploads/pics/44636_pic_square_1314224723.jpg"
        },
        {
          "typeName": "Myspace",
          "type": "myspace",
          "typeId": "myspace",
          "url": "http://a2.ec-images.myspacecdn.com/profile01/114/97c130815ed44e47a19080f970706dbe/s.jpg"
        },
        {
          "typeName": "Linkedin",
          "type": "linkedin",
          "typeId": "linkedin",
          "url": "http://media.linkedin.com/mpr/mpr/shrink_80_80/p/2/000/086/2c8/2444fae.jpg"
        },
        {
          "typeName": "Other",
          "type": "google profile",
          "typeId": "other",
          "url": "http://www.google.com/s2/photos/public/AIbEiAIAAABECJno7ZvvpqKayAEiC3ZjYXJkX3Bob3RvKihmYTAyNmViNGY4MDNjYWJiMDg2Y2I5ZjBhZDhlMWM5YzU2NTc1ZjVlMAG03P6jBkfZy8aWki7yrEp6B4HUDQ"
        },
        {
          "typeName": "Quora",
          "type": "quora",
          "typeId": "quora",
          "url": "http://d2o7bfz2il9cb7.cloudfront.net/main-thumb-235179-100-jKTxWZQMbAl9MrGaLTDAs19WUiZoCuPW.jpeg"
        },
        {
          "typeName": "Linkedin",
          "type": "linkedin",
          "typeId": "linkedin",
          "url": "http://media.linkedin.com/mpr/pub/image-8kD9yK95845PPSkQ3U3ryL0B2bTfOSKQ2EBfy9Si3h5FEh6_/bart-lorang.jpg"
        },
        {
          "typeName": "Youtube",
          "type": "youtube",
          "typeId": "youtube",
          "url": "http://i4.ytimg.com/vi/oVB_WdQXzls/default.jpg"
        },
        {
          "typeName": "Foursquare",
          "type": "foursquare",
          "typeId": "foursquare",
          "url": "https://img-s.foursquare.com/userpix_thumbs/V4ZAH05UTC5TWEYM.jpg"
        },
        {
          "typeName": "Foursquare",
          "type": "foursquare",
          "typeId": "foursquare",
          "url": "https://playfoursquare.s3.amazonaws.com/userpix_thumbs/V4ZAH05UTC5TWEYM.jpg"
        },
        {
          "typeName": "Other",
          "type": "google profile",
          "typeId": "other",
          "url": "http://www.google.com/s2/photos/public/AIbEiAIAAABECJno7ZvvpqKayAEiC3ZjYXJkX3Bob3RvKigzMWI2OTJkYmVkZjE0NDMyMWZiZjY0ZmRjNGFkMWMyYjFiZTJiNzI5MAGr1Y9MU6EKYlsSx1dHmsrn4AYZ8g"
        },
        {
          "typeName": "Gravatar",
          "type": "gravatar",
          "typeId": "gravatar",
          "url": "http://1.gravatar.com/avatar/956b7dca7c77a12c43ebe9ae09dfaba8"
        },
        {
          "typeName": "Gravatar",
          "type": "gravatar",
          "typeId": "gravatar",
          "url": "http://2.gravatar.com/avatar/e1e94ffac5967195d81ac3e68ba8aa0c"
        },
        {
          "typeName": "Quora",
          "type": "quora",
          "typeId": "quora",
          "url": "http://qph.cf.quoracdn.net/main-thumb-235179-200-jKTxWZQMbAl9MrGaLTDAs19WUiZoCuPW.jpeg"
        }
      ],
      "contactInfo": {
        "familyName": "Lorang",
        "fullName": "Bart Lorang",
        "givenName": "Bart",
        "websites":
        [
          {
            "url": "https://www.fullcontact.com"
          }
        ],
        "chats":
        [
          {
            "handle": "lorangb@gmail.com",
            "client": "gtalk"
          },
          {
            "handle": "bart.lorang",
            "client": "skype"
          }
        ]
      },
      "status": 200,
      "organizations":
      [
        {
          "startDate": "2010-01",
          "isPrimary": false,
          "title": "Co-Founder & CEO",
          "name": "FullContact"
        },
        {
          "startDate": "2010-01",
          "isPrimary": false,
          "title": "CEO & Co-Founder",
          "name": "FullContact"
        },
        {
          "startDate": "2011-05",
          "isPrimary": false,
          "name": "Techstars",
          "endDate": "2011-08"
        },
        {
          "startDate": "2010-01",
          "isPrimary": false,
          "title": "Co-Founder & CEO",
          "name": "Rainmaker Technologies",
          "endDate": ""
        },
        {
          "startDate": "",
          "isPrimary": true,
          "title": "Chief Executive Officer and Co-Founder",
          "name": "FullContact",
          "endDate": ""
        },
        {
          "isPrimary": false,
          "title": "CEO",
          "name": "FullContact"
        }
      ],
      "demographics": {
        "age": "32",
        "locationGeneral": "Boulder, Colorado",
        "gender": "Male",
        "ageRange": "25-34"
      },
      "socialProfiles":
      [
        {
          "typeName": "Twitter",
          "id": 5998422,
          "username": "lorangb",
          "followers": 674,
          "following": 489,
          "bio": "CEO & Co-Founder of @FullContactApp and @FullContactAPI - Tech Entrepreneur and Angel Investor.",
          "rss": "http://twitter.com/statuses/user_timeline/lorangb.rss",
          "type": "twitter",
          "typeId": "twitter",
          "url": "http://www.twitter.com/lorangb"
        },
        {
          "typeName": "Tungle Me",
          "username": "bartlorang",
          "type": "tungleme",
          "typeId": "tungleme",
          "url": "http://tungle.me/bartlorang"
        },
        {
          "id": "6xtewkyGle",
          "typeName": "Linkedin",
          "followers": "1071",
          "following": "1071",
          "username": "bartlorang",
          "bio": "Co-Founder & CEO at FullContact",
          "type": "linkedin",
          "typeId": "linkedin",
          "url": "http://www.linkedin.com/in/bartlorang"
        },
        {
          "id": "1634762",
          "typeName": "Plancast",
          "username": "lorangb",
          "bio": "CEO & Co-Founder of FullContact",
          "type": "plancast",
          "typeId": "plancast",
          "url": "http://plancast.com/lorangb"
        },
        {
          "typeName": "Myspace",
          "id": "137200880",
          "type": "myspace",
          "typeId": "myspace",
          "url": "http://www.myspace.com/137200880"
        },
        {
          "typeName": "About Me",
          "username": "lorangb",
          "type": "aboutme",
          "typeId": "aboutme",
          "url": "http://about.me/lorangb"
        },
        {
          "typeName": "Google Profile",
          "id": "114426306375480734745",
          "username": "lorangb",
          "type": "googleprofile",
          "typeId": "googleprofile",
          "url": "http://profiles.google.com/lorangb"
        },
        {
          "typeName": "Quora",
          "username": "bart-lorang",
          "type": "quora",
          "typeId": "quora",
          "url": "http://www.quora.com/bart-lorang"
        },
        {
          "id": "10245647",
          "typeName": "Foursquare",
          "username": "lorangb",
          "type": "foursquare",
          "typeId": "foursquare",
          "url": "http://foursquare.com/lorangb"
        },
        {
          "typeName": "Youtube",
          "username": "lorangb",
          "rss": "http://youtube.com/rss/user/lorangb/videos.rss",
          "type": "youtube",
          "typeId": "youtube",
          "url": "http://youtube.com/user/lorangb"
        },
        {
          "typeName": "Picasa",
          "id": "114426306375480734745",
          "username": "lorangb",
          "rss": "http://picasaweb.google.com/data/feed/base/user/lorangb?kind=album&alt=rss&hl=en_US&access=public",
          "type": "picasa",
          "typeId": "picasa",
          "url": "http://picasaweb.google.com/lorangb"
        },
        {
          "typeName": "Google Plus",
          "id": "114426306375480734745",
          "username": "lorangb",
          "bio": "CEO & Co-Founder of FullContact",
          "type": "googleplus",
          "typeId": "googleplus",
          "url": "https://plus.google.com/114426306375480734745"
        },
        {
          "typeName": "Klout",
          "username": "lorangb",
          "type": "klout",
          "typeId": "klout",
          "url": "http://www.klout.com/lorangb"
        },
        {
          "id": "18197740",
          "typeName": "Gravatar",
          "username": "blorang",
          "bio": "http://about.me/lorangb",
          "type": "gravatar",
          "typeId": "gravatar",
          "url": "http://gravatar.com/blorang"
        },
        {
          "id": "39267654@N00",
          "typeName": "Flickr",
          "username": "39267654@N00",
          "rss": "http://api.flickr.com/services/feeds/photos_public.gne?id=39267654@N00&lang=en-us&format=rss_200",
          "type": "flickr",
          "typeId": "flickr",
          "url": "http://www.flickr.com/people/39267654@N00/"
        }
      ],
      "digitalFootprint": {
        "topics":
        [
          {
            "value": "entrepreneurship",
            "provider": "klout"
          },
          {
            "value": "angel investing",
            "provider": "klout"
          },
          {
            "value": "techstars",
            "provider": "klout"
          },
          {
            "value": "boulder",
            "provider": "klout"
          },
          {
            "value": "tequila",
            "provider": "klout"
          }
        ],
        "scores":
        [
          {
            "value": 47.73,
            "provider": "klout",
            "type": "general"
          },
          {
            "value": 21,
            "provider": "klout",
            "type": "amplification"
          },
          {
            "value": 763,
            "provider": "klout",
            "type": "reach"
          },
          {
            "value": 31.1,
            "provider": "klout",
            "type": "network"
          }
        ]
      }
    }
  }
}