API rốt cuộc là gì? (Phần 2: Hiểu giới hạn và cách sử dụng dữ liệu)

Đây là phần tiếp theo của bài viết trước, API rốt cuộc là gì và tôi sử dụng API như thế nào?

Nếu bạn đã đọc bài viết đầu tiên về API, bạn đã có ý tưởng khái quát về API và cách sử dụng. Nhưng giờ đây, bạn sẽ muốn hiểu cách xác định khi nào là đủ và cách sắp xếp dữ liệu này. Việc nắm rõ thông tin này rất quan trọng để bạn không dùng hết đơn vị API và biết cần làm gì với dữ liệu thô của mình.

Hiểu giới hạn của bạn

Khi thực hiện một lệnh gọi API, bạn cần hiểu mình đang yêu cầu bao nhiêu dữ liệu. Khi sử dụng API, hãy luôn ghi nhớ các điều khoản dịch vụ. Trong điều khoản API của chúng tôi, bạn sẽ thấy chúng tôi quy định rằng bạn không thể thực hiện quá 10 lệnh gọi mỗi giây hoặc quá 2 lệnh gọi đồng thời. Với hầu hết các lệnh gọi API bạn thực hiện, bạn sẽ được yêu cầu đặt giới hạn hiển thị. Giới hạn này sẽ xác định lượng dữ liệu bạn nhận được cũng như số đơn vị bị tính phí. Hãy cùng xem một ví dụ khác về keyword Organic Search của Domain:

https://api.semrush.com/?type=domain_organic&key=XXXXXXXXXXXXXXXXXXXXXX&display_filter=%2B%7CPh%7CCo%7Cseo&display_limit=10&export_columns=Ph,Po,Pp,Pd,Nq,Cp,Ur,Tr,Tc,Co,Nr,Td&domain=seobook.com&display_sort=tr_desc&database=us

Giờ hãy phân tích từng phần như trong bài viết trước:

https://api.semrush.com/?type=domain_organic: Loại lệnh gọi API đang thực hiện

&key=XXXXXXXXXXXXXXXXXXXXXX: Khóa API

&display_filter=%2B%7CPh%7CCo%7Cseo: Bộ lọc đang dùng; nhấp vào đây để biết thêm thông tin

&display_limit=10: Số dòng dữ liệu bạn nhận được

&export_columns=Ph,Po,Pp,Pd,Nq,Cp,Ur,Tr,Tc,Co,Nr,Td: Các cột sẽ hiển thị trong kết quả

&domain=seobook.com: Domain được truy vấn

&display_sort=tr_desc: Cách sắp xếp dữ liệu

&database=us: Cơ sở dữ liệu chứa dữ liệu

&display_limit

Phần giới hạn hiển thị là yếu tố then chốt để xác định dữ liệu bạn nhận được. Phần này cho biết bạn sẽ nhận được bao nhiêu dòng dữ liệu trong lệnh gọi API và cuối cùng, bạn sẽ phải trả bao nhiêu để nhận dữ liệu đó.

Như đã giải thích trong bài viết trước, mỗi dòng dữ liệu sẽ tiêu tốn một lượng API unit nhất định, tùy thuộc vào lệnh gọi. Với ví dụ ở trên, mỗi dòng dữ liệu tiêu tốn 10 API unit. Vì vậy, nếu giữ giới hạn hiển thị ở mức 10, lệnh gọi API này sẽ tiêu tốn 100 API unit. Bạn có thể điều chỉnh giới hạn hiển thị thành bất kỳ con số nào để lấy dữ liệu mình cần. Chỉ cần thêm một số 0, chi phí có thể tăng từ 100 lên 1.000 unit.

Nếu không chắc mình còn bao nhiêu API unit, bạn có thể vào mục Accounts API ở thanh bên trái rồi dùng lệnh gọi API “Check API Units Balance”. Lệnh này sẽ cho biết số API unit còn lại trong tài khoản của bạn. Bạn cũng có thể vào Tariff Summary trong menu thả xuống ở góc trên bên phải màn hình, bên dưới Profile. Hãy cân nhắc dữ liệu này khi thực hiện các lệnh gọi API. Bạn cần theo dõi số dư API unit để không vượt quá hạn mức.

Cách sử dụng dữ liệu

&export_columns

Phần này của lệnh gọi API đề cập đến các cột khác nhau sẽ hiển thị trong kết quả. Bạn có thể nhập bao nhiêu mục tùy thích, miễn là chúng phù hợp với lệnh gọi đang thực hiện. Phần này không ảnh hưởng đến số unit bị tính vào tài khoản của bạn. Chỉ dòng giới hạn hiển thị mới ảnh hưởng đến số unit. Các cột xuất cho biết mỗi dòng sẽ trả về bao nhiêu dữ liệu. Bạn có thể xem các cột khác nhau có thể thêm vào lệnh gọi API tại đây.

Sau khi cấu trúc lệnh gọi API chính xác, bạn đã sẵn sàng truy xuất kết quả. Khi nhập lệnh gọi vào thanh địa chỉ của trình duyệt, dữ liệu sẽ hiển thị như sau:

Keyword;Position;Previous Position;Position Difference;Search Volume;CPC;Url;Traffic (%);Traffic Cost (%);Competition;Number of Results;
Trends seo tools;1;1;0;4400;5.59;http://tools.seobook.com/;5.53;8.05;0.96;27100000;0.99,0.99,0.99,0.99,0.99,0.81,0.81,0.81,0.81,0.81,0.81,0.81
seo;12;7;-5;90500;13.01;http://www.seobook.com/;3.15;10.66;0.96;224000000;0.99,0.99,0.82,0.82,0.82,0.82,0.82,0.82,0.82,0.82,0.82,0.82
seo training;1;1;0;1900;11.82;http://training.seobook.com/;2.39;7.35;0.94;6990000;0.99,0.79,0.79,0.79,0.79,0.79,0.67,0.79,0.79,0.67,0.67,0.67
free seo tools;1;1;0;1600;4.49;http://tools.seobook.com/;2.01;2.35;0.95;21000000;0.84,0.99,0.84,0.84,0.68,0.68,0.68,0.99,0.84,0.84,0.53,0.46
seo tool;1;1;0;880;5.12;http://tools.seobook.com/;1.10;1.47;0.98;10400000;0.45,0.45,0.45,0.45,0.37,0.45,0.63,0.45,0.55,0.99,0.45,0.37
seo book;1;1;0;880;11.87;http://www.seobook.com/;1.10;3.42;0.54;29800000;0.77,0.68,0.68,0.68,0.68,0.68,0.68,0.55,0.99,0.68,0.45,0.45
seobook;1;1;0;880;3.39;http://www.seobook.com/;1.10;0.97;0.05;119000;0.99,0.99,0.99,0.88,0.88,0.88,0.88,0.88,0.72,0.72,0.59,0.59
seo toolbar;1;1;0;390;2.11;http://tools.seobook.com/seo-toolbar/;0.49;0.26;0.35;1580000;0.99,0.81,0.99,0.81,0.81,0.81,0.81,0.81,0.67,0.54,0.44,0.35
seo infographic;1;1;0;210;0.00;http://www.seobook.com/learn-seo/infographics/;0.26;0.00;0.07;3560000;0.81,0.81,0.99,0.81,0.66,0.66,0.81,0.81,0.66,0.66,0.53,0.53
seotools;1;1;0;210;5.05;http://tools.seobook.com/;0.26;0.34;0.84;2950000;0.42,0.65,0.81,0.99,0.81,0.65,0.81,0.81,0.99,0.99,0.81,0.81

Có lẽ dữ liệu này trông khá rối mắt với bạn, và hiện tại đúng là vậy. Đọc dữ liệu ở dạng hiển thị này sẽ rất khó. Vậy bạn nên làm gì? Cách tốt nhất để hiểu thông tin này là thực hiện các bước tương tự như trong video bên dưới:

Trước tiên, hãy sao chép dữ liệu đang hiển thị trong trình duyệt. Sau đó, mở Microsoft Excel (hoặc một chương trình tương tự) và dán dữ liệu vào ô đầu tiên. Tiếp theo, hãy dùng tính năng “Text to Columns” trong menu Data. Tính năng này sẽ phân tách dữ liệu theo một ký tự được chỉ định.

Như bạn thấy trong video phía trên, tiếp theo hãy chọn dấu chấm phẩy làm ký tự phân tách dữ liệu. Sau khi chọn Finish, dữ liệu sẽ được sắp xếp gọn gàng và dễ đọc. Điều này sẽ hữu ích khi bạn thực hiện nhiều API call và muốn nhanh chóng sắp xếp, lưu dữ liệu.

Hy vọng phần này giúp bạn hiểu rõ hơn về cách sử dụng API và xác minh rằng mình đang yêu cầu đúng dữ liệu khi thực hiện API call. Ngoài ra, hãy chọn giới hạn phù hợp cho các lệnh gọi để nắm rõ giới hạn và tránh sử dụng quá mức. Những thông tin này sẽ giúp bạn tiến thêm một bước đến việc lấy được dữ liệu mong muốn.

Bạn còn câu hỏi nào không? Hãy để lại bình luận bên dưới hoặc liên hệ với chúng tôi qua mail@semrush.com để kết nối với đội ngũ Customer Support, hoặc gọi (855) 814-4510.