{ "swagger": "2.0", "info": { "version": "", "title": "apidescription?format=wadl&ver=1440335015000", "description": "", "license": { "name": "MIT", "url": "http://github.com/gruntjs/grunt/blob/master/LICENSE-MIT" } }, "host": "api.linkedin.com", "basePath": "/v1/", "securityDefinitions": {}, "schemes": [ "https" ], "consumes": [ "application/json" ], "produces": [ "application/json" ], "paths": { "/people/~?format=json": { "get": { "description": "", "operationId": "Get_PeopleFormatJson_", "produces": [ "application/json" ], "parameters": [ { "name": "Accept-Language", "in": "query", "required": false, "x-is-map": false, "default": "es-ES, en-US, it-IT", "type": "string", "description": "Some members have profiles in multiple languages. To specify the language you prefer, set the values to a comma separated list of locales ordered from highest to lowest preference. For example, if your preferred order is Spanish, then English (American), and finally Italian, your header should be: Accept-Language: es-ES, en-US, it-IT. At present, we will always return data if possible. So, if you specify just one locale, but the member hasn't localized her profile for that locale, we will return data in her primary language. We support any language the member has specified. For example, for Simplified Chinese, use zh-CN. However, the six most popular languages are: en-US, fr-FR, de-DE, it-IT, pt-BR and es-ES." } ], "responses": { "200": { "description": "", "schema": { "type": "object" } } } } }, "/people/~:(id,num-connections,picture-url)?format=json": { "get": { "description": "", "operationId": "Get_PeopleAPIIdNumConnectionsPictureUrlFormatJson_", "produces": [ "application/json" ], "parameters": [], "responses": { "200": { "description": "", "schema": { "type": "object" } } } } }, "/people/~/shares?format=json": { "post": { "description": "", "operationId": "Create_PeopleAPISharesFormatJson_", "produces": [ "application/json" ], "parameters": [ { "name": "Content-Type", "in": "query", "required": true, "x-is-map": false, "default": "true", "type": "string", "description": "The content type." }, { "name": "x-li-format", "in": "query", "required": true, "x-is-map": false, "default": "true", "type": "string", "description": "The content type." } ], "responses": { "200": { "description": "", "schema": { "type": "object" } } } } }, "/companies/{id}/is-company-share-enabled?format=json": { "get": { "description": "", "operationId": "Get_CompaniesIsCompanyShareEnabledFormatJson_", "produces": [ "application/json" ], "parameters": [ { "name": "id", "in": "path", "required": true, "x-is-map": false, "default": "1337", "type": "string", "description": "The unique internal numeric company identifier." } ], "responses": { "200": { "description": "", "schema": { "type": "object" } } } } }, "/companies/{id}/relation-to-viewer/is-company-share-enabled?format=json": { "get": { "description": "", "operationId": "Get_CompaniesRelationToViewerIsCompanyShareEnabledFormatJson_", "produces": [ "application/json" ], "parameters": [ { "name": "id", "in": "path", "required": true, "x-is-map": false, "default": "1337", "type": "string", "description": "The unique internal numeric company identifier." } ], "responses": { "200": { "description": "", "schema": { "type": "object" } } } } }, "/companies?format=json&is-company-admin=true": { "get": { "description": "", "operationId": "Get_CompaniesFormatJsonIsCompanyAdminTrue_", "produces": [ "application/json" ], "parameters": [ { "name": "start", "in": "query", "required": false, "x-is-map": false, "default": 0.0, "type": "integer", "format": "int64", "description": "The offset value for paginating company results by." }, { "name": "count", "in": "query", "required": false, "x-is-map": false, "default": 10.0, "type": "integer", "format": "int64", "description": "Maximum number of companies to return." } ], "responses": { "200": { "description": "", "schema": { "type": "object" } } } } }, "/companies/{id}?format=json": { "get": { "description": "", "operationId": "Get_CompaniesFormatJsonById_", "produces": [ "application/json" ], "parameters": [ { "name": "id", "in": "path", "required": true, "x-is-map": false, "default": "1337", "type": "string", "description": "The unique internal numeric company identifier." } ], "responses": { "200": { "description": "", "schema": { "type": "object" } } } } }, "/companies/{id}:(id,name,ticker,description)?format=json": { "get": { "description": "", "operationId": "Get_CompaniesIdNameTickerDescriptionFormatJson_", "produces": [ "application/json" ], "parameters": [ { "name": "id", "in": "path", "required": true, "x-is-map": false, "default": "1337", "type": "string", "description": "The unique internal numeric company identifier." } ], "responses": { "200": { "description": "", "schema": { "type": "object" } } } } }, "/companies/{id}/updates?format=json": { "get": { "description": "", "operationId": "Get_CompaniesUpdatesFormatJsonById_", "produces": [ "application/json" ], "parameters": [ { "name": "id", "in": "path", "required": true, "x-is-map": false, "default": "1337", "type": "string", "description": "The unique internal numeric company identifier." }, { "name": "event-type", "in": "query", "required": false, "x-is-map": false, "default": 0.0, "type": "integer", "format": "int64", "description": "The offset value for paginating update results by." }, { "name": "start", "in": "query", "required": false, "x-is-map": false, "default": 0.0, "type": "integer", "format": "int64", "description": "The offset value for paginating update results by." }, { "name": "count", "in": "query", "required": false, "x-is-map": false, "default": 10.0, "type": "integer", "format": "int64", "description": "Maximum number of updates to return." } ], "responses": { "200": { "description": "", "schema": { "type": "object" } } } } }, "/companies/{id}/updates/key={update-key}?format=json": { "get": { "description": "", "operationId": "Get_FormatJson_", "produces": [ "application/json" ], "parameters": [ { "name": "id", "in": "path", "required": true, "x-is-map": false, "default": "1337", "type": "string", "description": "The unique internal numeric company identifier." }, { "name": "update-key", "in": "path", "required": true, "x-is-map": false, "default": "UPDATE-c1337-5986518397255454720", "type": "string", "description": "The unique company update identifier." } ], "responses": { "200": { "description": "", "schema": { "type": "object" } } } } }, "/companies/{id}/updates/key={update-key}/update-comments?format=json": { "get": { "description": "", "operationId": "Get_UpdateCommentsFormatJson_", "produces": [ "application/json" ], "parameters": [ { "name": "id", "in": "path", "required": true, "x-is-map": false, "default": "1337", "type": "string", "description": "The unique internal numeric company identifier." }, { "name": "update-key", "in": "path", "required": true, "x-is-map": false, "default": "UPDATE-c1337-5986518397255454720", "type": "string", "description": "The unique company update identifier." } ], "responses": { "200": { "description": "", "schema": { "type": "object" } } } } }, "/companies/{id}/updates/key={update-key}/likes?format=json": { "get": { "description": "", "operationId": "Get_LikesFormatJson_", "produces": [ "application/json" ], "parameters": [ { "name": "id", "in": "path", "required": true, "x-is-map": false, "default": "1337", "type": "string", "description": "The unique internal numeric company identifier." }, { "name": "update-key", "in": "path", "required": true, "x-is-map": false, "default": "UPDATE-c1337-5986518397255454720", "type": "string", "description": "The unique company update identifier." } ], "responses": { "200": { "description": "", "schema": { "type": "object" } } } } }, "/companies/{id}/shares?format=json": { "post": { "description": "", "operationId": "Create_CompaniesSharesFormatJsonById_", "produces": [ "application/json" ], "parameters": [ { "name": "id", "in": "path", "required": true, "x-is-map": false, "default": "2414183", "type": "string", "description": "The unique internal numeric company identifier." }, { "name": "Content-Type", "in": "query", "required": true, "x-is-map": false, "default": "true", "type": "string", "description": "The content type." }, { "name": "x-li-format", "in": "query", "required": true, "x-is-map": false, "default": "true", "type": "string", "description": "The content type." } ], "responses": { "200": { "description": "", "schema": { "type": "object" } } } } }, "/companies/{id}/num-followers?format=json&seniorities=vp,d&jobFunc=it&geos=na.ca": { "get": { "description": "", "operationId": "Get_CompaniesNumFollowersFormatJsonSenioritiesVpDJobFuncItGeosNaCa_", "produces": [ "application/json" ], "parameters": [ { "name": "id", "in": "path", "required": true, "x-is-map": false, "default": "1337", "type": "string", "description": "The unique internal numeric company identifier." }, { "name": "geos", "in": "query", "required": false, "x-is-map": false, "type": "string", "description": "Segment by a particular geographic area." }, { "name": "companySizes", "in": "query", "required": false, "x-is-map": false, "type": "string", "description": "Segment by a particular company size targeting code." }, { "name": "jobFunc", "in": "query", "required": false, "x-is-map": false, "type": "string", "description": "Segment by member job function targeting code." }, { "name": "industries", "in": "query", "required": false, "x-is-map": false, "type": "string", "description": "Segment by member industry." }, { "name": "seniorities", "in": "query", "required": false, "x-is-map": false, "type": "string", "description": "Segment by member seniority level targeting code." } ], "responses": { "200": { "description": "", "schema": { "type": "object" } } } } }, "/companies/{id}/updates/key={update-key}/update-comments-as-company/": { "post": { "description": "", "operationId": "UpdateCommentsAsCompany_", "produces": [ "application/json" ], "parameters": [ { "name": "id", "in": "path", "required": true, "x-is-map": false, "default": "2414183", "type": "string", "description": "The unique internal numeric company identifier." }, { "name": "update-key", "in": "path", "required": true, "x-is-map": false, "default": "UPDATE-c2414183-5986959985467285504", "type": "string", "description": "The unique company update identifier." }, { "name": "Content-Type", "in": "query", "required": true, "x-is-map": false, "default": "true", "type": "string", "description": "The content type." }, { "name": "x-li-format", "in": "query", "required": true, "x-is-map": false, "default": "true", "type": "string", "description": "The content type." } ], "responses": { "200": { "description": "", "schema": { "type": "object" } } } } }, "/companies/{id}/historical-follow-statistics?format=json": { "get": { "description": "", "operationId": "Get_CompaniesHistoricalFollowStatisticsFormatJson_", "produces": [ "application/json" ], "parameters": [ { "name": "id", "in": "path", "required": true, "x-is-map": false, "default": "1337", "type": "string", "description": "The unique internal numeric company identifier." }, { "name": "time-granularity", "in": "query", "required": true, "x-is-map": false, "type": "string", "description": "Granularity of statistics. Supported values are:\n\t day\n\t month" }, { "name": "start-timestamp", "in": "query", "required": true, "x-is-map": false, "type": "string", "description": "Starting timestamp of when the stats search should begin (milliseconds since epoch)" }, { "name": "end-timestamp", "in": "query", "required": false, "x-is-map": false, "type": "string", "description": "Ending timestamp of when the stats search should end (milliseconds since epoch). The current time will be used if parameter not set." } ], "responses": { "200": { "description": "", "schema": { "type": "object" } } } } }, "/companies/{id}/historical-status-update-statistics?format=json": { "get": { "description": "", "operationId": "Get_CompaniesHistoricalStatusUpdateStatisticsFormatJson_", "produces": [ "application/json" ], "parameters": [ { "name": "id", "in": "path", "required": true, "x-is-map": false, "default": "1337", "type": "string", "description": "The unique internal numeric company identifier." }, { "name": "time-granularity", "in": "query", "required": true, "x-is-map": false, "type": "string", "description": "Granularity of statistics. Supported values are:\n\t day\n\t month" }, { "name": "start-timestamp", "in": "query", "required": true, "x-is-map": false, "type": "string", "description": "Starting timestamp of when the stats search should begin (milliseconds since epoch)" }, { "name": "end-timestamp", "in": "query", "required": false, "x-is-map": false, "type": "string", "description": "Ending timestamp of when the stats search should end (milliseconds since epoch). The current time will be used if parameter not set." }, { "name": "update-key", "in": "query", "required": false, "x-is-map": false, "type": "string", "description": "Optionally provide an update key value to return statistics for a specific company update." } ], "responses": { "200": { "description": "", "schema": { "type": "object" } } } } }, "/companies/{id}/company-statistics?format=json": { "get": { "description": "", "operationId": "Get_CompaniesCompanyStatisticsFormatJsonById_", "produces": [ "application/json" ], "parameters": [ { "name": "id", "in": "path", "required": true, "x-is-map": false, "default": "1337", "type": "string", "description": "The unique internal numeric company identifier." } ], "responses": { "200": { "description": "", "schema": { "type": "object" } } } } } } }