{"_id":"591021f9d4cd662d00c82fa4","parentDoc":null,"project":"54343293fa5527080064f472","__v":1,"version":{"_id":"591021f7d4cd662d00c82f9e","project":"54343293fa5527080064f472","__v":1,"createdAt":"2017-05-08T07:44:55.941Z","releaseDate":"2017-05-08T07:44:55.941Z","categories":["591021f8d4cd662d00c82f9f","591021f8d4cd662d00c82fa0"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"Engagement","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"591021f8d4cd662d00c82fa0","__v":0,"version":"591021f7d4cd662d00c82f9e","project":"54343293fa5527080064f472","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2014-10-16T06:03:53.832Z","from_sync":false,"order":1,"slug":"api","title":"API"},"user":"5434326ae532ff0800e185ab","updates":[],"next":{"pages":[],"description":""},"createdAt":"2014-10-16T05:50:24.469Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","examples":{"codes":[]},"method":"post","results":{"codes":[{"language":"json","code":"{\"count\":921,\"bulk_id\":\"4a7d9ca68177713593c713cc584a7edf9ee9017c\"}","name":"Success"}]},"auth":"never","params":[{"_id":"5451129414af501a00b50c20","ref":"","in":"body","required":false,"desc":"","default":"[[app:key]]","type":"string","name":"apikey"},{"_id":"5911823425cf46250072d640","ref":"","in":"body","required":false,"desc":"","default":"one URL per line","type":"string","name":"urls"}],"url":"/v1.0/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":"post","title":"/v1.0/bulk"}

post/v1.0/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')}}
urls:
stringone URL per line

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.