{"__v":7,"_id":"543f5ca014785f080042d295","category":{"__v":4,"_id":"543f5fc9d09132080000b857","pages":["543f5bc7baae8a08005f62a7","543f5ca014785f080042d295","543f5cb414785f080042d298","543f5febd09132080000b858","543f6017a32c0c0800f30b37","543f6042a32c0c0800f30b39","543f603ad09132080000b85b"],"project":"54343293fa5527080064f472","version":"54343293fa5527080064f475","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2014-10-16T06:03:53.832Z","from_sync":false,"order":2,"slug":"api","title":"API"},"editedParams":true,"editedParams2":true,"is_link":false,"project":"54343293fa5527080064f472","user":"5434326ae532ff0800e185ab","version":{"__v":4,"_id":"54343293fa5527080064f475","project":"54343293fa5527080064f472","createdAt":"2014-10-07T18:36:03.237Z","releaseDate":"2014-10-07T18:36:03.237Z","categories":["54343293fa5527080064f476","543f5d6114785f080042d29d","543f5fc9d09132080000b857","5446f625beb6320800da6eef"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2014-10-16T05:50:24.469Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"basic_auth":false,"method":"post","results":{"codes":[{"name":"Success","code":"{\"count\":921,\"bulk_id\":\"4a7d9ca68177713593c713cc584a7edf9ee9017c\"}","language":"json"}]},"try":false,"auth":"never","params":[{"_id":"5451129414af501a00b50c20","ref":"","in":"body","required":false,"desc":"","default":"[[app:key]]","type":"string","name":"apikey"}],"url":"/bulk"},"isReference":false,"order":1,"body":"URLs are transmitted one per line in the POST body, with a trailing line-break after the final URL.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"POST [[app:plan]].sharedcount.com/bulk?apikey=[[app:key]] \\n\\nRequest Body:\\nhttp://www.google.com/\\nhttp://www.amazon.com/\\n\",\n      \"language\": \"shell\"\n    }\n  ]\n}\n[/block]\n\n\nSuccessfully completed API queries done via batching will count against your daily API quota. Requests exceeding your API quota will be rejected. Under the covers, the bulk endpoint acts as a layer on top of the existing API; one which handles the queueing and processing of a large number of queries for the purposes of reducing transit overhead.\n\nWhen you make your POST request, you'll receive a response giving you a bulk_id, and also the number of URLs that were accepted and queued for querying. Invalid URLs will be silently ignored.\n\nUse the [GET /bulk](https://docs.sharedcount.com/v1.0/docs/bulk-1) call to retrieve your data from the endpoint after posting.","excerpt":"Post a large number of URLs all at once to calculate bulk social counts. (This page is incomplete.)","slug":"bulk","type":"endpoint","title":"/bulk"}

post/bulk

Post a large number of URLs all at once to calculate bulk social counts. (This page is incomplete.)

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Body Params

apikey:
string{{keys('key')}}

Result Format


Documentation

URLs are transmitted one per line in the POST body, with a trailing line-break after the final URL. [block:code] { "codes": [ { "code": "POST [[app:plan]].sharedcount.com/bulk?apikey=[[app:key]] \n\nRequest Body:\nhttp://www.google.com/\nhttp://www.amazon.com/\n", "language": "shell" } ] } [/block] Successfully completed API queries done via batching will count against your daily API quota. Requests exceeding your API quota will be rejected. Under the covers, the bulk endpoint acts as a layer on top of the existing API; one which handles the queueing and processing of a large number of queries for the purposes of reducing transit overhead. When you make your POST request, you'll receive a response giving you a bulk_id, and also the number of URLs that were accepted and queued for querying. Invalid URLs will be silently ignored. Use the [GET /bulk](https://docs.sharedcount.com/v1.0/docs/bulk-1) call to retrieve your data from the endpoint after posting.