Kategoriler

Lead'leri API Kullanarak Nasıl Otomatik Bir Şekilde İndirebilirim?

API Talebi

HTTP Yöntemi: GET

Endpoint: /api/lead

Sorgu Parametreleri:

• take (isteğe bağlı): Geri dönülecek lead sayısı. Varsayılan değer 50'dir. Örnek: take=1

• skip (isteğe bağlı): Atlanacak potansiyel müşteri sayısı. Varsayılan değer 0'dır. Örnek: skip=5

• StartDate ve EndDate (isteğe bağlı): Elde edilmesi istenen müşteri verilerinin zaman aralığı. Varsayılan 1 gündür. Maksimum süre 90 gündür.

Başlıklar:

• x-token (personal data > API key)

• x-campaign id

Example Request:
GET /api/leads?take=100&skip=50&startDate=2024-02-01&endDate=2024-03-01 HTTP/1.1
Host: example.com
Headers:
  x-token: {APIkey}
  x-campaign-id: {Campaignld}
1
2
3
4
5
6

API Yanıtı

HTTP Status Code: 200
Headers:
Content-Type: application/json
Example Response:
HTTP/1.1 200 OK

{
  "leads": [
    {
      "date": "2023-02-28T09:48:36.362Z",
      "sessionId": "111e1a1b-1ca1-1111-ad1b-11111ffa1",
      "accountId": 1111,
      "location": {
        "ip": "111.11.11.11",
        "countryCode": "UK",
        "country": "United Kingdom",
        "region": "London",
        "regionCode": "1",
        "city": "London",
        "latitude": "11.11111",
        "longitude": "11.11111",
        "timezone": "Europe/London",
        "asOrganization": "John Doe's Organization",
        "postalCode": "1111"
      },
      "url": "https://johndoe.com/?ps-preview=4948",
      "page": "/",
      "host": "johndoe.com",
      "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/110.0.0.0 Safari/537.36",
      "device": "Desktop",
      "resolution": "1112x1112",
      "os": "Mac OS",
      "browser": "Chrome",
      "language": "en-US",
      "referrer": "",
      "type": "lead",
      "campaignId": 1111,
      "triggerIntegrations": true,
      "meta": {
        "utm_campaign": null,
        "utm_source": null,
        "utm_medium": null,
        "utm_content": null,
        "utm_term": null,
        "ps-preview": "1111"
      },
      "formData": {
        "ULLE3_email_input": "[email protected]",
        "IKQMY_text_input": "123asd"
      }
    ]
  }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

Curl:

curl --location 'https://app.popupsmart.com/api/leads?take=2&skip=10' \ --header 'x-token: V2-1ZTPYBU1IBY1FQNHP1M11CCRDQFSU1F1CQAF1MHGQGCQQWXH1KTB11B1XBLH1BPK' \ --header 'x-campaign-id: 1111'

1
2

Notlar:

Header, authentication için geçerli bir x-token and x-campaign-id içermelidir.

• Yanıt içindeki leads alanı bir dizi lead verisi içerir.

Take ve Skip parametreleri, sonuçları sayfalara ayırmak için kullanılabilir.