List your LinkedIn scrapers
Returns the scrapers of your workspace, newest first, 20 per page. Deleted scrapers are not returned.
Use it to show a history or to find a scraper id. To follow one extraction, poll GET /linkedin-scrappers/{id} instead: it is lighter and returns the same object.
For running segmented scrapers (large searches split into chunks, Grow and Scale plans), two computed fields are added: nextRunningSegment (when the next chunk is scheduled) and betweenSegment (true when no chunk is being extracted right now).
Pitfall: each object also contains internal fields not described here (cursors, legacy ids). Do not rely on them.
Authorization
apiKey Your 48 character API key, sent as is (a Bearer prefix is tolerated). Create it at https://v3.emelia.io/settings/api.
In: header
Query Parameters
Page number, starting at 0. 20 scrapers per page. Missing, non numeric or negative values mean 0. An empty scraps array means you went past the last page.
0 <= value0Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/linkedin-scrappers?page=0" \ -H "Authorization: YOUR_API_KEY"{ "success": true, "scraps": [ { "_id": "66f1a2b3c4d5e6f7a8b9c0d1", "authes": [ "66e0f1a2b3c4d5e6f7a8b9c0", "66e0f1a2b3c4d5e6f7a8b9c1" ], "name": "Acme CTOs France", "url": "https://www.linkedin.com/sales/search/people?query=(filters%3AList((type%3ACURRENT_TITLE%2Cvalues%3AList((text%3ACTO%2CselectionType%3AINCLUDED)))%2C(type%3AREGION%2Cvalues%3AList((text%3AFrance%2CselectionType%3AINCLUDED)))))", "scrapType": "people", "status": "running", "totalContact": 7400, "scrapIndex": 5000, "maxContacts": 0, "segmented": true, "segments": [ { "_id": "66f1a2b3c4d5e6f7a8b9c101", "url": "https://www.linkedin.com/sales/search/people?query=(filters%3AList((type%3ACURRENT_TITLE%2Cvalues%3AList((text%3ACTO%2CselectionType%3AINCLUDED)))%2C(type%3AREGION%2Cvalues%3AList((text%3AFrance%2CselectionType%3AINCLUDED)))%2C(type%3ACOMPANY_HEADCOUNT%2Cvalues%3AList((id%3AB%2Ctext%3A1-10%2CselectionType%3AINCLUDED)))))", "scrapIndex": 2500, "count": 2500, "complete": true }, { "_id": "66f1a2b3c4d5e6f7a8b9c102", "url": "https://www.linkedin.com/sales/search/people?query=(filters%3AList((type%3ACURRENT_TITLE%2Cvalues%3AList((text%3ACTO%2CselectionType%3AINCLUDED)))%2C(type%3AREGION%2Cvalues%3AList((text%3AFrance%2CselectionType%3AINCLUDED)))%2C(type%3ACOMPANY_HEADCOUNT%2Cvalues%3AList((id%3AC%2Ctext%3A11-50%2CselectionType%3AINCLUDED)))))", "scrapIndex": 2500, "count": 2500, "complete": true }, { "_id": "66f1a2b3c4d5e6f7a8b9c103", "url": "https://www.linkedin.com/sales/search/people?query=(filters%3AList((type%3ACURRENT_TITLE%2Cvalues%3AList((text%3ACTO%2CselectionType%3AINCLUDED)))%2C(type%3AREGION%2Cvalues%3AList((text%3AFrance%2CselectionType%3AINCLUDED)))%2C(type%3ACOMPANY_HEADCOUNT%2Cvalues%3AList((id%3AD%2Ctext%3A51-200%2CselectionType%3AINCLUDED)))))", "scrapIndex": 0, "count": 2400 } ], "estimatedEnd": "2026-10-12T13:40:00.000Z", "nextRunningSegment": "2026-10-12T09:11:00.000Z", "betweenSegment": true, "date": "2026-10-11T08:02:41.512Z", "lastUpdate": "2026-10-11T11:14:03.220Z", "enrichEnabled": false, "enrichIndex": 0, "enrichFound": 0, "enrichPhoneEnabled": false, "enrichPhoneIndex": 0, "enrichPhoneFound": 0, "webhooks": [ { "_id": "66f1a2b3c4d5e6f7a8b9c0f1", "webhookUrl": "https://hooks.acme.example/emelia/scrapper", "events": [ "FINISHED", "ERROR" ] } ], "convertedListId": null }, { "_id": "66fd0e1f2a3b4c5d6e7f8a90", "authes": [ "66e0f1a2b3c4d5e6f7a8b9c0" ], "name": "Acme marketing leads", "url": "https://www.linkedin.com/sales/lists/people/7212345678901234567?sortCriteria=CREATED_TIME&sortOrder=DESCENDING", "scrapType": "people", "status": "done", "totalContact": 1840, "scrapIndex": 1840, "maxContacts": 0, "segmented": false, "segments": [], "date": "2026-10-02T14:05:09.000Z", "lastUpdate": "2026-10-02T14:41:55.000Z", "enrichEnabled": true, "startEnrichDate": "2026-10-02T15:20:11.000Z", "enrichIndex": 1840, "enrichFound": 1022, "enrichPhoneEnabled": false, "enrichPhoneIndex": 0, "enrichPhoneFound": 0, "webhooks": [], "convertedListId": "66f2b3c4d5e6f7a8b9c0d1e2" } ]}