9. Retrieve past leads looking back 90 days
GET {{baseUrl}}/adFormResponses?q=account&account=urn%3Ali%3AsponsoredAccount%3A{{sponsoredaccount_id}}&projection=(paging,elements*(id,leadType,account~(id,name,reference~(localizedName)),campaign~(id,name),creative~(id,variables(data((,share~(text))))),form~(form(landingPage,hiddenFields,name)),formResponse(consentResponses*(accepted,consent~),submittedAt,answers*(question~,answerDetails))))&timeRange=(start:1668283699000,end:1668456499000)
The user may have already started receiving leads prior to setting up the integration with your platform. Allowing the user to backfill these leads ensures their chosen destination is up to date.
Using the same call from the previous step, you can use the timeRange.start
and timeRange.end
params to pull leads as far back as 90 days.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
q | string | ||
account | string | ||
projection | string | ||
timeRange | string |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Authorization | string | ||
LinkedIn-Version | string | ||
X-Restli-Protocol-Version | string |
RESPONSES
status: OK
{"paging":{"total":2,"start":0,"count":10,"links":[]},"elements":[{"creative~":{"variables":{"data":{"com.linkedin.ads.SponsoredUpdateCreativeVariables":{"contentAuthor":{"organization":"urn:li:organization:73841066"},"activity":"urn:li:activity:6975908550300585984","callToActionEnabled":true,"sponsoredStatusUpdateContentType":"ARTICLE","mediaAspectRatio":{"widthAspect":1.754386,"heightAspect":1.0},"share":"urn:li:share:6975908549293928448","share~":{"text":{"text":"howdy there!"}},"directSponsoredContent":true}}},"id":241112256},"form~":{"form":{"name":"spanish with custom questions","hiddenFields":[],"landingPage":"https://www.linkedin.com"}},"account~":{"name":"Christa's Updated Ad Acount","reference":"urn:li:organization:73841066","id":508679858,"reference~":{"localizedName":"Highlander Cranberries LLC"}},"creative":"urn:li:sponsoredCreative:241112256","form":"urn:li:adForm:7149286","leadType":"SPONSORED","campaign":"urn:li:sponsoredCampaign:198356826","campaign~":{"name":"Spain campaign","id":198356826},"id":"urn:li:adFormResponse:0cd561e8-8654-4cc0-9d9c-03cf7f50520a-6","account":"urn:li:sponsoredAccount:508679858","formResponse":{"answers":[{"question":"urn:li:adFormQuestion:(urn:li:adForm:7149286,3)","question~":{"questionId":3,"question":"Correo electrónico","memberProfileField":"EMAIL","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"Email address","predefinedField":"EMAIL"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"cbrehm@linkedin.com"}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7149286,5)","question~":{"questionId":5,"question":"Correo electrónico del trabajo","memberProfileField":"EMAIL","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"Work email","predefinedField":"WORK_EMAIL"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"cbrehm@linkedin.com"}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7149286,6)","question~":{"questionId":6,"question":"favorite color","typeSpecificQuestionDetails":{"com.linkedin.ads.MultipleChoiceQuestionDetails":{"options":[{"com.linkedin.ads.TextOptionQuestion":{"text":"red"}},{"com.linkedin.ads.TextOptionQuestion":{"text":"green"}}]}},"name":"Custom question 0"},"answerDetails":{"com.linkedin.ads.MultipleChoiceAnswer":{"options":[{"com.linkedin.ads.TextOptionAnswer":{"index":1}}]}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7149286,1)","question~":{"questionId":1,"question":"Nombre","memberProfileField":"FIRST_NAME","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"First name","predefinedField":"FIRST_NAME"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"Christa"}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7149286,2)","question~":{"questionId":2,"question":"Apellidos","memberProfileField":"LAST_NAME","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"Last name","predefinedField":"LAST_NAME"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"Brehm"}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7149286,4)","question~":{"questionId":4,"question":"Cargo","memberProfileField":"JOB_TITLE","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"Job title","predefinedField":"JOB_TITLE"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"Senior Partner Engineer"}}}],"consentResponses":[],"submittedAt":1677549476277}},{"creative~":{"variables":{"data":{"com.linkedin.ads.SponsoredUpdateCreativeVariables":{"contentAuthor":{"organization":"urn:li:organization:73841066"},"activity":"urn:li:activity:6904869836686544896","callToActionEnabled":false,"sponsoredStatusUpdateContentType":"IMAGE","mediaAspectRatio":{"widthAspect":1.5037594,"heightAspect":1.0},"share":"urn:li:share:6904869836015464450","share~":{"text":{"text":"Sleepy cat"}},"directSponsoredContent":true}}},"id":241257736},"form~":{"form":{"name":"Form with written spanish","hiddenFields":[{"name":"hidden_field","value":"abc678"},{"name":"campo_escondido","value":"def789"}],"landingPage":"https://www.linkedin.com"}},"account~":{"name":"Christa's Updated Ad Acount","reference":"urn:li:organization:73841066","id":508679858,"reference~":{"localizedName":"Highlander Cranberries LLC"}},"creative":"urn:li:sponsoredCreative:241257736","form":"urn:li:adForm:7234246","leadType":"SPONSORED","campaign":"urn:li:sponsoredCampaign:198356826","campaign~":{"name":"Spain campaign","id":198356826},"id":"urn:li:adFormResponse:ed31e922-0d3f-4eb6-b6a4-603d32a8752d-6","account":"urn:li:sponsoredAccount:508679858","formResponse":{"answers":[{"question":"urn:li:adFormQuestion:(urn:li:adForm:7234246,3)","question~":{"questionId":3,"question":"Correo electrónico","memberProfileField":"EMAIL","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"Email address","predefinedField":"EMAIL"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"cbrehm@linkedin.com"}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7234246,6)","question~":{"questionId":6,"question":"Correo electrónico del trabajo","memberProfileField":"EMAIL","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"Work email","predefinedField":"WORK_EMAIL"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"cbrehm@linkedin.com"}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7234246,7)","question~":{"questionId":7,"question":"Cuál es tu color favorito","typeSpecificQuestionDetails":{"com.linkedin.ads.MultipleChoiceQuestionDetails":{"options":[{"com.linkedin.ads.TextOptionQuestion":{"text":"Rojo"}},{"com.linkedin.ads.TextOptionQuestion":{"text":"Azul"}}]}},"name":"Custom question 0"},"answerDetails":{"com.linkedin.ads.MultipleChoiceAnswer":{"options":[{"com.linkedin.ads.TextOptionAnswer":{"index":0}}]}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7234246,8)","question~":{"questionId":8,"question":"¿Dónde creciste?","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"Custom question 1"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"En los Estados Unidos"}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7234246,1)","question~":{"questionId":1,"question":"Nombre","memberProfileField":"FIRST_NAME","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"First name","predefinedField":"FIRST_NAME"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"Christa"}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7234246,2)","question~":{"questionId":2,"question":"Apellidos","memberProfileField":"LAST_NAME","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"Last name","predefinedField":"LAST_NAME"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"Brehm"}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7234246,4)","question~":{"questionId":4,"question":"Cargo","memberProfileField":"JOB_TITLE","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"Job title","predefinedField":"JOB_TITLE"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"Senior Partner Engineer"}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7234246,5)","question~":{"questionId":5,"question":"Función","memberProfileField":"JOB_FUNCTION","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"Function","predefinedField":"JOB_FUNCTION"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"Ingeniería"}}}],"consentResponses":[{"accepted":true,"consent":"urn:li:adFormConsent:(urn:li:adForm:7234246,0)","consent~":{"consentId":0,"consentRequired":true,"content":" marque mi casilla de verificación personalizada!"}}],"submittedAt":1677549459303}}]}